Função de retorno de chamada PFNKSADDEVENT (ks.h)
Uma rotina de do AVStrMiniAddEvent de um minidriver AVStream é chamada quando um cliente se registra para ser notificado de um evento. Essa rotina é opcional.
Sintaxe
PFNKSADDEVENT Pfnksaddevent;
NTSTATUS Pfnksaddevent(
[in] PIRP Irp,
[in] PKSEVENTDATA EventData,
[in] _KSEVENT_ENTRY *EventEntry
)
{...}
Parâmetros
[in] Irp
Especifica o IRP que descreve a solicitação de adição de eventos.
[in] EventData
Ponteiro para uma estrutura de KSEVENTDATA que descreve o método de notificação para esse evento.
[in] EventEntry
Ponteiro para uma estrutura de KSEVENT_ENTRY gerada por AVStream que descreve como o evento é disparado.
Valor de retorno
AVStrMiniAddEvent deve retornar STATUS_SUCCESS ou um erro específico ao evento que está sendo habilitado.
Observações
Se você não fornecer um manipulador de eventos de adição, o AVStream adicionará o evento à lista de objetos. Consulte tratamento de eventos no AVStream.
Frequentemente, esse retorno de chamada implementa um comportamento específico do fornecedor e chama KsFilterAddEvent ou KsPinAddEvent. O minidriver passa o ponteiro EventEntry recebido aqui em chamadas para KsFilterAddEvent ou KsPinAddEvent.
O minidriver especifica o endereço dessa rotina no AddHandler membro de uma estrutura KSEVENT_ITEM. Tratamento de Eventos no AVStream descreve como o minidriver fornece essa estrutura para o driver de classe.
Se um minidriver AVStream especificar AddHandler como não NULL, o AVStream não adicionará o item à lista de eventos do objeto. Se o minidriver especificar um AddHandler e não adicionar o evento à lista de eventos do objeto por meio de KsDefaultAddEventHandler() ou uma chamada Ks*AddEvent , o minidriver será responsável por limpar o evento.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ks.h (incluir Ks.h) |