KsPinGetLeadingEdgeStreamPointer-Funktion (ks.h)
Die KsPinGetLeadingEdgeStreamPointer--Funktion übernimmt den führenden Edgestreamzeiger für die Warteschlange, 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 Edgestreamzeiger abgerufen werden soll.
[in] State
Dieser Parameter gibt an, wie der führende Edgedatenstromzeiger abgerufen wird. Dies kann eine der folgenden Sein:
KSSTREAM_POINTER_STATE_UNLOCKED
Rufen Sie den führenden Datenstromzeiger 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 außerdem, dass Frames, die einem entsperrten Datenstromzeiger zugeordnet sind, abgebrochen werden können.
KSSTREAM_POINTER_STATE_LOCKED
Rufen Sie den Zeiger des führenden Edgedatenstroms ab, und sperren Sie diesen. Wenn dem Datenstromzeiger kein Datenrahmen zugeordnet ist, geben Sie NULL-zurück. Wenn ein nichtNULL- Zeiger zurückgegeben wird, handelt es sich um einen gesperrten Datenstromzeiger, der einem Datenrahmen zugeordnet ist. Frames, die einem gesperrten Datenstromzeiger zugeordnet sindkö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, da der Pin keine Warteschlange zugeordnet ist, die angibt, dass der Pin nicht den Standardmäßigen Transportmechanismus verwendet. Alternativ kann ein Rückgabewert von NULL- auftreten, da beim Versuch, den führenden Rand zu sperren, ein Fehler aufgetreten ist, der angibt, dass dem führenden Rand kein Datenframe zugeordnet ist.
Bemerkungen
Filter, die Pin-Centric Processing implementieren, rufen häufig KsPinGetLeadingEdgeStreamPointerauf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | <=DISPATCH_LEVEL |
Siehe auch
KsPinGetTrailingEdgeStreamPointer-