Funzione KsStreamPointerLock (ks.h)

La funzione KsStreamPointerLock tenta di bloccare il puntatore di flusso specificato.

Sintassi

KSDDKAPI NTSTATUS KsStreamPointerLock(
  [in] PKSSTREAM_POINTER StreamPointer
);

Parametri

[in] StreamPointer

Puntatore a una struttura KSSTREAM_POINTER che rappresenta il puntatore del flusso per tentare di bloccare.

Valore restituito

KsStreamPointerLock restituisce STATUS_SUCCESS, a indicare che il puntatore di flusso è stato bloccato o un codice di errore appropriato. STATUS_DEVICE_NOT_READY è il codice di errore consueto che indica che non è stato possibile bloccare il frame. Questo codice di errore indica spesso che il frame a cui streamPointer puntava è stato annullato.

Commenti

Un puntatore al flusso bloccato garantisce che al puntatore di flusso sia associato un frame di dati e che questo frame non venga annullato finché il blocco viene mantenuto. Il minidriver deve bloccare un puntatore di flusso prima di tentare di accedere ai dati a cui punta il puntatore del flusso.

Se il pin a cui fa riferimento il puntatore di flusso specifica che i mapping di dispersione/raccolta DMA devono essere generati tramite KSPIN_FLAG_GENERATE_MAPPINGS, AVStream genera i mapping quando il puntatore di flusso è bloccato.

Vedere anche Stream puntatori.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX.
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib
IRQL	<=DISPATCH_LEVEL

Vedi anche

KsStreamPointerUnlock