Funzione KsPinGetLeadingEdgeStreamPointer (ks.h)

Articolo
02/07/2025

La funzione KsPinGetGetLeadingEdgeStreamPointer acquisisce il puntatore del 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 al KSPIN struttura proprietaria della coda per cui deve essere acquisito il puntatore di flusso del bordo iniziale.

[in] State

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

KSSTREAM_POINTER_STATE_UNLOCKED

Acquisire il puntatore del 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 del flusso perimetrale iniziale. Se al puntatore di flusso non è associato alcun frame di dati, restituire NULL. Se viene restituito un puntatore nullnon, si tratta di un puntatore di flusso bloccato e a cui è associato un frame di dati. I fotogrammi associati a un puntatore di flusso bloccato non possono essere annullati.

Valore restituito

KsPinGetGetLeadingEdgeStreamPointer restituisce un puntatore a una struttura KSSTREAM_POINTER o NULL. È possibile che si verifichi un valore restituito di NULL perché al pin non è associata alcuna coda, a indicare che il pin non usa il meccanismo di trasporto standard. In alternativa, è possibile che si verifichi un valore restituito di NULL perché un tentativo di blocco del bordo iniziale non è riuscito, a indicare che al bordo iniziale non è associato alcun frame di dati.

Osservazioni

I filtri che implementano Pin-Centric Processing spesso chiamano KsPinGetLeadingEdgeStreamPointer.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX.
piattaforma di destinazione	Universale
intestazione	ks.h (include Ks.h)
libreria	Ks.lib
IRQL	<=DISPATCH_LEVEL