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 |