Função KsDisableEvent (ks.h)

A função KsDisableEvent desabilita os eventos solicitados por meio de IOCTL_KS_DISABLE_EVENT. Ele responde a todos os eventos habilitados anteriormente por meio de KsEnableEvent. Se o comprimento do buffer de entrada for zero, supõe-se que todos os eventos na lista devem ser desabilitados. Essa função só pode ser chamada em PASSIVE_LEVEL.

Sintaxe

KSDDKAPI NTSTATUS KsDisableEvent(
  [in]      PIRP              Irp,
  [in, out] PLIST_ENTRY       EventsList,
  [in]      KSEVENTS_LOCKTYPE EventsFlags,
  [in]      PVOID             EventsLock
);

Parâmetros

[in] Irp

Especifica o IRP passado para a função de remoção, que usa o IRP para obter informações de contexto. O objeto de arquivo associado ao IRP é usado para comparar com o objeto de arquivo especificado originalmente ao habilitar o evento. Isso permite que uma única lista de eventos seja usada para vários clientes diferenciados por objetos de arquivo.

[in, out] EventsList

Aponta para o cabeçalho da lista de KSEVENT_ENTRY itens nos quais o evento pode ser encontrado. Se um cliente usa várias listas de eventos e não sabe em qual lista esse evento está, o cliente pode chamar essa função várias vezes. Um evento não encontrado retornará STATUS_UNSUCCESSFUL.

[in] EventsFlags

Especifica um sinalizador KSEVENTS_LOCKTYPE especificando o tipo de bloqueio de exclusão a ser usado no acesso à lista de eventos. Se nenhum sinalizador estiver definido, nenhum bloqueio será tomado.

[in] EventsLock

Usado para sincronizar o acesso a um elemento na lista. Depois que o elemento tiver sido acessado, ele será marcado como sendo excluído para que as solicitações de remoção subsequentes falhem. O bloqueio é liberado depois de chamar a função de remoção, se houver. A função de remoção deve ser sincronizada com a geração de eventos antes de realmente remover o elemento da lista.

Retornar valor

A função KsDisableEvent retorna STATUS_SUCCESS se tiver êxito ou um erro específico para o evento que está sendo habilitado. A função sempre define o IO_STATUS_BLOCK. Campo de informações do PIRP. Elemento IoStatus dentro do IRP para zero. Ele não define o IO_STATUS_BLOCK. Campo status, nem conclui o IRP.

Comentários

É importante que o manipulador de remoção sincronize com a geração de eventos para garantir que, quando o evento for removido da lista, ele não esteja sendo atendido no momento. Presume-se que o acesso a essa lista seja controlado com o bloqueio passado.

Requisitos

Confira também

KsEnableEvent