Função de retorno de chamada PFNKSREMOVEEVENT (ks.h)

Artigo
02/26/2024

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)