KsStreamPointerGetNextClone function

The KsStreamPointerGetNextClone function returns the clone stream pointer that was cloned immediately after the specified clone.

Syntax


PKSSTREAM_POINTER KsStreamPointerGetNextClone(
  _In_ PKSSTREAM_POINTER StreamPointer
);

Parameters

StreamPointer [in]

A pointer to a KSSTREAM_POINTER structure representing the clone stream pointer for which the clone stream pointer cloned immediately after it on the same pin is returned.

Return value

KsStreamPointerGetNextClone returns a pointer to a KSSTREAM_POINTER structure representing the clone stream pointer that was cloned immediately after StreamPointer on the same pin. Alternatively, it returns NULL indicating that either StreamPointer is the last clone on the pin or that StreamPointer is not a clone. If not a clone, StreamPointer is either the leading or trailing edge stream pointer.

Remarks

The returned pointer always refers to the same pin as StreamPointer. KsStreamPointerGetNextClone, in conjunction with KsPinGetFirstCloneStreamPointer,can be used to enumerate all clone stream pointers on a given pin in the order in which they were cloned.

Also see Stream Pointers.

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

KsPinGetFirstCloneStreamPointer
KsStreamPointerClone
KsStreamPointerDelete

 

 

Send comments about this topic to Microsoft

Show: