Funzione KsPinGetLeadingEdgeStreamPointer (ks.h)

Articolo
02/29/2024

La funzione KsPinGetLeadingEdgeStreamPointer acquisisce il puntatore al flusso perimetrale iniziale per la coda associata al pin specificato.

Sintassi

KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
  [in] PKSPIN                 Pin,
  [in] KSSTREAM_POINTER_STATE State
);

Parametri

[in] Pin

Puntatore alla struttura KSPIN proprietaria della coda per cui deve essere acquisito il puntatore di flusso perimetrale iniziale.

[in] State

Questo parametro specifica come acquisire il puntatore al flusso perimetrale iniziale. Può essere uno dei valori seguenti:

KSSTREAM_POINTER_STATE_UNLOCKED

Acquisire il puntatore al flusso perimetrale iniziale indipendentemente dal fatto che faccia riferimento o meno a un frame di dati.

Non è possibile eseguire alcun tentativo di accesso ai dati associati al puntatore fino a quando il puntatore non viene bloccato. Si noti anche che i fotogrammi associati a un puntatore di flusso sbloccato possono essere annullati.

KSSTREAM_POINTER_STATE_LOCKED

Acquisire e bloccare il puntatore al flusso perimetrale iniziale. Se al puntatore di flusso non è associato alcun frame di dati, restituire NULL. Se viene restituito un puntatore nonNull , si tratta di un puntatore di flusso bloccato e a cui è associato un frame di dati. I frame associati a un puntatore di flusso bloccato non possono essere annullati.

Valore restituito

KsPinGetLeadingEdgeStreamPointer restituisce un puntatore a una struttura KSSTREAM_POINTER o NULL. Un valore restituito null può verificarsi perché non esiste alcuna coda associata al pin, a indicare che il pin non utilizza il meccanismo di trasporto standard. In alternativa, può verificarsi un valore restituito NULL perché un tentativo di blocco del bordo iniziale non è riuscito, a indicare che non è presente alcun frame di dati associato al bordo iniziale.

Commenti

I filtri che implementano l'elaborazione basata su pin spesso chiamano KsPinGetLeadingEdgeStreamPointer.

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