Função de retorno de chamada PFNKSADDEVENT (ks.h)
A rotina 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 evento.
[in] EventData
Ponteiro para uma estrutura KSEVENTDATA que descreve o método de notificação para esse evento.
[in] EventEntry
Ponteiro para uma estrutura de KSEVENT_ENTRY gerada pelo AVStream que descreve como o evento é disparado.
Retornar valor
AVStrMiniAddEvent deve retornar STATUS_SUCCESS ou um erro específico para o evento que está sendo habilitado.
Comentários
Se você não fornecer um manipulador de eventos de adição, o AVStream adicionará o evento à lista de objetos. Consulte Manipulação 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 membro AddHandler de uma estrutura KSEVENT_ITEM . Manipulação 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 de uma chamada Ks*AddEvent , o minidriver será responsável por limpar o evento.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ks.h (inclua Ks.h) |