Funzione di callback PFNKSADDEVENT (ks.h)
La routine AVStrMiniAddEvent di un minidriver AVStream viene chiamata routine quando un client esegue la registrazione per ricevere una notifica di un evento. Questa routine è facoltativa.
Sintassi
PFNKSADDEVENT Pfnksaddevent;
NTSTATUS Pfnksaddevent(
[in] PIRP Irp,
[in] PKSEVENTDATA EventData,
[in] _KSEVENT_ENTRY *EventEntry
)
{...}
Parametri
[in] Irp
Specifica l'IRP che descrive la richiesta di aggiunta dell'evento.
[in] EventData
Puntatore a una struttura KSEVENTDATA che descrive il metodo di notifica per questo evento.
[in] EventEntry
Puntatore a una struttura di KSEVENT_ENTRY generata da AVStream che descrive come viene attivato l'evento.
Valore restituito
AVStrMiniAddEvent deve restituire STATUS_SUCCESS o un errore specifico per l'evento abilitato.
Osservazioni
Se non si specifica un gestore eventi di aggiunta, AVStream aggiunge l'evento all'elenco di oggetti. Vedere gestione degli eventi in AVStream.
Spesso questo callback implementa un comportamento specifico del fornitore e quindi chiama KsFilterAddEvent o KsPinAddEvent. Il minidriver passa il puntatore EventEntry ricevuto qui nelle chiamate a KsFilterAddEvent o KsPinAddEvent.
Il minidriver specifica l'indirizzo di questa routine nel membro addHandler di una struttura di KSEVENT_ITEM. Gestione eventi in AVStream descrive come il minidriver fornisce questa struttura al driver di classe.
Se un minidriver AVStream specifica AddHandler come non NULL, AVStream non aggiunge l'elemento all'elenco eventi dell'oggetto. Se minidriver specifica un AddHandler e non aggiunge l'evento all'elenco di eventi dell'oggetto tramite KsDefaultAddEventHandler() o una chiamata Ks*AddEvent , il minidriver è responsabile della pulizia dell'evento.
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 | Desktop |
| intestazione | ks.h (include Ks.h) |