KsStreamPointerLock-Funktion (ks.h)
Die KsStreamPointerLock--Funktion versucht, den angegebenen Datenstromzeiger zu sperren.
Syntax
KSDDKAPI NTSTATUS KsStreamPointerLock(
[in] PKSSTREAM_POINTER StreamPointer
);
Parameter
[in] StreamPointer
Ein Zeiger auf eine KSSTREAM_POINTER Struktur, die den Datenstromzeiger darstellt, um zu sperren.
Rückgabewert
KsStreamPointerLock gibt entweder STATUS_SUCCESS zurück, was angibt, dass der Datenstromzeiger gesperrt wurde, oder einen entsprechenden Fehlercode. STATUS_DEVICE_NOT_READY ist der übliche Fehlercode, der angibt, dass der Frame nicht gesperrt werden konnte. Dieser Fehlercode bedeutet häufig, dass der Frame, auf den StreamPointer verweist, abgebrochen wurde.
Bemerkungen
Ein gesperrter Datenstromzeiger garantiert, dass dem Datenstromzeiger ein Datenframe zugeordnet ist und dass dieser Frame nicht abgebrochen wird, solange die Sperre beibehalten wird. Der Minidriver sollte einen Datenstromzeiger sperren, bevor versucht wird, auf die Daten zuzugreifen, auf die der Datenzeiger verweist.
Wenn der Pin, auf den der Datenstromzeiger verweist, angibt, dass DMA-Punkt-/Gather-Zuordnungen mithilfe von KSPIN_FLAG_GENERATE_MAPPINGS generiert werden sollen, generiert AVStream die Zuordnungen, wenn der Datenstromzeiger gesperrt ist.
Siehe auch stream pointers.
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 |