KsStreamPointerClone-Funktion (ks.h)

Artikel
02/29/2024

Die KsStreamPointerClone-Funktion erstellt einen Klon eines bestimmten Streamzeigers.

Syntax

KSDDKAPI NTSTATUS KsStreamPointerClone(
  [in]           PKSSTREAM_POINTER  StreamPointer,
  [in, optional] PFNKSSTREAMPOINTER CancelCallback,
  [in]           ULONG              ContextSize,
  [out]          PKSSTREAM_POINTER  *CloneStreamPointer
);

Parameter

[in] StreamPointer

Ein Zeiger auf eine KSSTREAM_POINTER Struktur, die den zu klonenden Streamzeiger darstellt.

[in, optional] CancelCallback

Optional. Ein Zeiger auf eine minidriver-bereitgestellte AVStrMiniCancelCallback-Routine . AVStream ruft diese Routine auf, wenn die mit CloneStreamPointer verknüpfte IRP abgebrochen wird.

[in] ContextSize

Dieser Parameter gibt an, wie viele Bytes an Minidriverkontextinformationen der resultierende Klonstreamzeiger enthalten soll. Bei nichtzero wird die angeforderte Anzahl von Bytes unmittelbar nach dem zurückgegebenen Streamzeiger zugeordnet, und das Feld Kontext von CloneStreamPointer verweist auf den zugewiesenen Arbeitsspeicher.

[out] CloneStreamPointer

Ein Zeiger auf einen Zeiger auf eine KSSTREAM_POINTER-Struktur . Nach erfolgreichem Abschluss des Klonvorgangs enthält CloneStreamPointer einen Zeiger auf die Adresse des geklonten Streamzeigers.

Rückgabewert

KsStreamPointerClone gibt entweder STATUS_SUCCESS zurück, was angibt, dass der Klonvorgang normal abgeschlossen wurde, oder einen entsprechenden Fehlercode.

Hinweise

Der resultierende Klon bezieht sich zunächst auf denselben Datenrahmen wie der ursprüngliche Datenstromzeiger und befindet sich im gleichen Zustand (gesperrt oder entsperrt). Das Hinzufügen eines Klonstreamzeigers, der auf einen Datenrahmen verweist, erhöht die Verweisanzahl für diesen bestimmten Frame. Beachten Sie, dass der betreffende Frame und damit die IRP, zu der der Frame gehört, erst abgeschlossen ist, wenn die Verweisanzahl auf 0 sinkt.

Sie können den ContextSize-Parameter dieses Aufrufs verwenden, um Zuordnungsaufrufe zu minimieren.

Siehe auch Stream Zeiger.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen.
Zielplattform	Universell
Header	ks.h (einschließlich Ks.h)
Bibliothek	Ks.lib
IRQL	<=DISPATCH_LEVEL