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

Artigo
02/29/2024

KStrFastHandler é uma rotina fornecida pelo driver que manipula uma solicitação de propriedade ou método sem a criação de um IRP.

Sintaxe

PFNKSFASTHANDLER Pfnksfasthandler;

BOOLEAN Pfnksfasthandler(
  [in]      PFILE_OBJECT FileObject,
  [in]      PKSIDENTIFIER Request,
  [in]      ULONG RequestLength,
  [in, out] PVOID Data,
  [in]      ULONG DataLength,
  [out]     PIO_STATUS_BLOCK IoStatus
)
{...}

Parâmetros

[in] FileObject

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

[in] Request

Especifica o parâmetro de propriedade original. Isso sempre estará em FILE_LONG_ALIGNMENT, mas não poderá estar em FILE_QUAD_ALIGNMENT.

[in] RequestLength

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

[in, out] Data

Especifica o parâmetro original de dados não alinhados.

[in] DataLength

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

[out] IoStatus

Especifica uma estrutura alinhada que é usada para retornar informações e status de erro. Essas informações são copiadas para a estrutura de status de E/S original após a conclusão.

Retornar valor

KStrFastHandler retornará TRUE se a chamada tiver sido tratada. Se a chamada não tiver sido tratada, ela retornará FALSE e um IRP será gerado para lidar com a solicitação.

Comentários

O minidriver fornece um ponto de entrada para essa rotina em KSFASTPROPERTY_ITEM ou KSFASTMETHOD_ITEM.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	ks.h (inclua Ks.h)

Compartilhar via