Função KsFastMethodHandler (ks.h)

Artigo
02/26/2024

A função KsFastMethodHandler lida com métodos rápidos solicitados por meio de IOCTL_KS_METHOD. Ele responde a todos os identificadores de método definidos pelos conjuntos que também estão contidos na lista de E/S rápida. Essa função só pode ser chamada em PASSIVE_LEVEL.

Sintaxe

KSDDKAPI BOOLEAN KsFastMethodHandler(
  [in]      PFILE_OBJECT       FileObject,
  [in]      PKSMETHOD          Method,
  [in]      ULONG              MethodLength,
  [in, out] PVOID              Data,
  [in]      ULONG              DataLength,
  [out]     PIO_STATUS_BLOCK   IoStatus,
  [in]      ULONG              MethodSetsCount,
  [in]      const KSMETHOD_SET *MethodSet
);

Parâmetros

[in] FileObject

Especifica o objeto de arquivo no qual a solicitação foi feita.

[in] Method

Especifica o parâmetro de método original. Isso sempre estará em FILE_LONG_ALIGNMENT, mas pode não estar em FILE_QUAD_ALIGNMENT.

[in] MethodLength

Especifica o comprimento indicado pelo chamador do parâmetro de método.

[in, out] Data

Especifica o parâmetro de dados não atribuído original.

[in] DataLength

Especifica o comprimento indicado pelo chamador do parâmetro de dados.

[out] IoStatus

Especifica uma estrutura alinhada usada para retornar informações e status de erro.

[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 KsFastMethodHandler retornará TRUE se a solicitação for tratada ou FALSE se a solicitação não for tratada. Se a solicitação não for tratada, um IRP será gerado. Se a solicitação foi tratada, a função define o elemento IoStatus-Information> como zero devido a um erro interno ou o elemento é definido por um manipulador de método. O manipulador de método também define o campo IoStatus-Status> quando o método é manipulado.

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 KsFastMethodHandler e KsMethodHandler . A função KsFastMethodHandler é usada para processar solicitações feitas por meio da interface de expedição de E/S rápida para Controle de Dispositivo. Ele só é usado para processar solicitações que podem ser atendidas rapidamente. O parâmetro Wait da função de E/S rápida não é passado e considerado VERDADEIRO.

Requisitos

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

Confira também

KsMethodHandler

Compartilhar via