KsStreamPointerGetNextClone function (ks.h)

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

Syntax

KSDDKAPI PKSSTREAM_POINTER KsStreamPointerGetNextClone(
  [in] PKSSTREAM_POINTER StreamPointer
);

Parameters

[in] StreamPointer

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

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib
IRQL <=DISPATCH_LEVEL

See also

KsPinGetFirstCloneStreamPointer

KsStreamPointerClone

KsStreamPointerDelete