KsPinGetLeadingEdgeStreamPointer
TOC
Collapse the table of content
Expand the table of content

KsPinGetLeadingEdgeStreamPointer function

The KsPinGetLeadingEdgeStreamPointer function acquires the leading edge stream pointer for the queue associated with the given pin.

Syntax


PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
  _In_ PKSPIN                 Pin,
  _In_ KSSTREAM_POINTER_STATE State
);

Parameters

Pin [in]

A pointer to the KSPIN structure owning the queue for which the leading edge stream pointer should be acquired.

State [in]

This parameter specifies how to acquire the leading edge stream pointer. Can be one of the following:

KSSTREAM_POINTER_STATE_UNLOCKED

Acquire the leading edge stream pointer regardless of whether it references a data frame or not.

No attempts can be made to access any data associated with the pointer until the pointer is locked. Also note that frames associated with an unlocked stream pointer can be canceled.

KSSTREAM_POINTER_STATE_LOCKED

Acquire and lock the leading edge stream pointer. If no data frame is associated with the stream pointer, return NULL. If a nonnull pointer is returned, it is a locked stream pointer and has a data frame associated with it. Frames associated with a locked stream pointer cannot be canceled.

Return value

KsPinGetLeadingEdgeStreamPointer returns a pointer to a KSSTREAM_POINTER structure or NULL. A return value of NULL may occur because there is no queue associated with the pin, indicating that the pin does not use the standard transport mechanism. Alternatively, a return value of NULL may occur because an attempt to lock the leading edge failed, indicating that there is no data frame associated with the leading edge.

Remarks

Filters that implement Pin-Centric Processing often call KsPinGetLeadingEdgeStreamPointer.

Requirements

Target platform

Universal

Version

Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.

Header

Ks.h (include Ks.h)

Library

Ks.lib

IRQL

<=DISPATCH_LEVEL

See also

KsStreamPointerLock
KsStreamPointerUnlock
KsStreamPointerAdvance
KsStreamPointerAdvanceOffsetsAndUnlock
KsStreamPointerClone
KsStreamPointerDelete
KsPinGetTrailingEdgeStreamPointer

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft