Funzione KsPinRegisterFrameReturnCallback (ks.h)

La funzione KsPinRegisterFrameReturnCallback registra un callback di restituzione dei fotogrammi con AVStream per un determinato pin.

Sintassi

void KsPinRegisterFrameReturnCallback(
  [in] PKSPIN              Pin,
  [in] PFNKSPINFRAMERETURN FrameReturn
);

Parametri

[in] Pin

Puntatore alla struttura AVStream KSPIN da inserire in modalità di inserimento registrando un callback di restituzione di fotogrammi.

[in] FrameReturn

Questo parametro fornisce l'indirizzo di una routine AVStrMiniFrameReturn fornita da minidriver.

Valore restituito

nessuno

Osservazioni

Se un pin ha registrato un callback di restituzione di fotogrammi prima della transizione da KSSTATE_STOP a KSSTATE_ACQUIRE, il pin viene inserito in modalità di inserimento. Ciò indica che il pin non riceverà buffer e li riempirà, ma inserisce manualmente i frame di dati nel circuito usando KsPinSubmitFrame o KsPinSubmitFrameMdl. Quando il frame di dati completa lo spostamento intorno al circuito e torna al pin su cui è stato inviato, AVStream lo ricicla chiamando AVStrMiniFrameReturn.

I minidriver che chiamano questa funzione sono direttamente responsabili dell'inserimento di fotogrammi nel circuito; non ricevono buffer da riempire e non interagiscono direttamente con la coda, come la maggior parte dei minidriver. Si noti anche che il callback restituito del frame deve essere registrato prima della creazione della sezione della pipe del kernel. La sezione della pipe del kernel viene creata quando il pin passa a KSSTATE_ACQUIRE. Per altre informazioni, vedere Inserimento di fotogrammi.

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	PASSIVE_LEVEL

Vedi anche

AVStrMiniFrameReturn

KsPinSubmitFrame

KsPinSubmitFrameMdl