KsStreamPointerGetNextClone function (ks.h)

Article
02/22/2024

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