Função KsMethodHandler (ks.h)

  • Artigo

A função KsMethodHandler manipula métodos solicitados por meio de IOCTL_KS_METHOD. Ele funciona com todos os identificadores de método definidos pelos conjuntos. A função só pode ser chamada em PASSIVE_LEVEL.

Sintaxe

KSDDKAPI NTSTATUS KsMethodHandler(
  [in] PIRP               Irp,
  [in] ULONG              MethodSetsCount,
  [in] const KSMETHOD_SET *MethodSet
);

Parâmetros

[in] Irp

Especifica o IRP com a solicitação de método sendo tratada.

[in] MethodSetsCount

Indica o número de estruturas do conjunto de métodos que estão sendo passadas.

[in] MethodSet

Especifica o ponteiro para a lista de informações do conjunto de métodos.

Retornar valor

A função KsMethodHandler retorna STATUS_SUCCESS se tiver êxito ou um erro específico ao método que está sendo tratado se não tiver êxito. A função sempre define o IO_STATUS_BLOCK. Campo de informações do PIRP. Elemento IoStatus dentro do IRP para zero devido a um erro interno, a menos que o elemento seja definido por um manipulador de método. A função não define o IO_STATUS_BLOCK. Campo status nem concluir o IRP.

Comentários

O proprietário de um conjunto de métodos pode executar pré-filtragem ou pós-filtragem do tratamento de método usando as funções KsMethodHandler e KsFastMethodHandler .

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ks.h (inclua Ks.h)
Biblioteca Ks.lib

Confira também

KsFastMethodHandler

KsMethodHandlerWithAllocator