KsPinGetLeadingEdgeStreamPointer-Funktion (ks.h)

Artikel
02/26/2024

Die KsPinGetLeadingEdgeStreamPointer-Funktion ruft den führenden Streamzeiger für die Warteschlange ab, die dem angegebenen Pin zugeordnet ist.

Syntax

KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
  [in] PKSPIN                 Pin,
  [in] KSSTREAM_POINTER_STATE State
);

Parameter

[in] Pin

Ein Zeiger auf die KSPIN-Struktur , die die Warteschlange besitzt, für die der führende Streamzeiger abgerufen werden soll.

[in] State

Dieser Parameter gibt an, wie der führende Streamzeiger abgerufen wird. Dabei kann es sich um eine der folgenden Methoden handeln:

KSSTREAM_POINTER_STATE_UNLOCKED

Rufen Sie den führenden Streamzeiger ab, unabhängig davon, ob er auf einen Datenrahmen verweist oder nicht.

Es können keine Versuche unternommen werden, auf daten zuzugreifen, die dem Zeiger zugeordnet sind, bis der Zeiger gesperrt ist. Beachten Sie auch, dass Frames, die einem entsperrten Streamzeiger zugeordnet sind, abgebrochen werden können.

KSSTREAM_POINTER_STATE_LOCKED

Abrufen und Sperren des führenden Streamzeigers. Wenn dem Datenstromzeiger kein Datenrahmen zugeordnet ist, wird NULL zurückgegeben. Wenn ein Zeiger ohneNULL zurückgegeben wird, handelt es sich um einen gesperrten Datenstromzeiger, dem ein Datenrahmen zugeordnet ist. Frames, die einem gesperrten Streamzeiger zugeordnet sind, können nicht abgebrochen werden.

Rückgabewert

KsPinGetLeadingEdgeStreamPointer gibt einen Zeiger auf eine KSSTREAM_POINTER-Struktur oder NULL zurück. Ein Rückgabewert von NULL kann auftreten, weil der Pin keine Warteschlange zugeordnet ist, was angibt, dass der Pin nicht den Standardtransportmechanismus verwendet. Alternativ kann ein Rückgabewert von NULL auftreten, weil beim Versuch, die führende Kante zu sperren, ein Fehler aufgetreten ist, was angibt, dass kein Datenrahmen mit der führenden Kante verknüpft ist.

Hinweise

Filter, die pinzentrierte Verarbeitung implementieren, rufen häufig KsPinGetLeadingEdgeStreamPointer auf.

Anforderungen

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