Funzione KsPinRegisterIrpCompletionCallback (ks.h)
La funzione KsPinRegisterIrpCompletionCallback registra una routine di callback definita da minidriver per un pin specificato. AVStream chiama la routine fornita da minidriver quando un'IRP completa un passaggio intorno al circuito e il frame associato all'IRP sta per essere riciclato o ritirato.
Sintassi
void KsPinRegisterIrpCompletionCallback(
[in] PKSPIN Pin,
[in] PFNKSPINIRPCOMPLETION IrpCompletion
);
Parametri
[in] Pin
Puntatore alla struttura KSPIN per cui registrare un callback di completamento.
[in] IrpCompletion
Questo parametro fornisce l'indirizzo di una routine AVStrMiniPinIrpCompletion da chiamare quando un IRP completa l'attraversamento del circuito e sta per essere riciclato o ritirato.
Valore restituito
nessuno
Osservazioni
KsPinRegisterIrpCompletionCallback deve essere chiamato in IRQL=PASSIVE_LEVEL prima che il pin venga inserito in KSSTATE_ACQUIRE. Per altre informazioni sugli stati dei pin, vedere KSSTATE.
Questa funzione viene spesso chiamata dall'invio di creazione del pin. Vedere KSPIN_DISPATCH.
KsPinRegisterIrpCompletionCallback è utile solo nei pin di origine IRP e viene in genere usato nei pin dell'origine dati. Per un pin dell'origine dati, il callback viene effettuato una volta che l'IRP viene completato al pin e sta per essere riciclato. Per un pin del sink di dati, tuttavia, il callback non è collegato direttamente al completamento di IRP. AVStream effettua comunque il callback quando l'IRP restituisce per il riciclo. Questa restituzione non si verifica finché l'IRP non viene passata attraverso tutte le code che devono usare i dati contenuti. Per informazioni sui pin di origine/sink IRP rispetto ai pin di origine dati/sink, vedere i membri flusso di dati e comunicazione della struttura KSPIN_DESCRIPTOR .
KsPinRegisterIrpCompletionCallback differisce significativamente da KsPinRegisterFrameReturnCallback in cui questa routine non inserisce il pin in alcuna nuova modalità; registra semplicemente una routine di callback.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in 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 |