Função de retorno de chamada PFNKSREMOVEEVENT (ks.h)
A rotina AVStrMiniRemoveEvent de um minidriver AVStream é chamada quando um cliente solicita que seja removido da fila de notificação para um evento. Essa rotina é opcional.
Sintaxe
PFNKSREMOVEEVENT Pfnksremoveevent;
void Pfnksremoveevent(
[in] PFILE_OBJECT FileObject,
[in] _KSEVENT_ENTRY *EventEntry
)
{...}
Parâmetros
[in] FileObject
Ponteiro para o objeto de arquivo para o qual remover o evento.
[in] EventEntry
Ponteiro para uma estrutura de KSEVENT_ENTRY gerada pelo AVStream.
Retornar valor
Nenhum
Comentários
O minidriver especifica o endereço dessa rotina no membro RemoveHandler de uma estrutura KSEVENT_ITEM . O Tratamento de Eventos no AVStream descreve como o minidriver fornece essa estrutura para o driver de classe.
Se o minidriver fornecer AVStrMiniRemoveEvent e não especificar um AddHandler ou especificar um AddHandler que chame KsXxxAddEvent, o AVStrMiniRemoveEvent do minidriver deverá chamar RemoveEntryList com um ponteiro para a estrutura LIST_ENTRY na estrutura KSEVENT_ENTRY :
&EventEntry -> ListEntry
Caso contrário, seu AVStrMiniRemoveEvent deverá reverter as etapas executadas no AddHandler.
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) |