KsStreamPointerLock-Funktion (ks.h)

Die KsStreamPointerLock-Funktion versucht, den angegebenen Streamzeiger zu sperren.

Syntax

KSDDKAPI NTSTATUS KsStreamPointerLock(
  [in] PKSSTREAM_POINTER StreamPointer
);

Parameter

[in] StreamPointer

Ein Zeiger auf eine KSSTREAM_POINTER Struktur, die den zu sperrenden Datenstromzeiger darstellt.

Rückgabewert

KsStreamPointerLock gibt entweder STATUS_SUCCESS zurück, was angibt, dass der Streamzeiger 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 zeigt, abgebrochen wurde.

Hinweise

Ein gesperrter Datenstromzeiger garantiert, dass dem Datenzeiger ein Datenrahmen zugeordnet ist und dass dieser Frame nicht abgebrochen wird, solange die Sperre beibehalten wird. Der Minitreiber sollte einen Streamzeiger sperren, bevor versucht wird, auf die Daten zuzugreifen, auf die der Streamzeiger verweist.

Wenn der Pin, auf den der Streamzeiger verweist, angibt, dass DMA-Punkt-/Sammlungszuordnungen mithilfe von KSPIN_FLAG_GENERATE_MAPPINGS generiert werden sollen, generiert AVStream die Zuordnungen, wenn der Streamzeiger gesperrt ist.

Siehe auch Stream Zeiger.

Anforderungen

Weitere Informationen

KsStreamPointerUnlock