Compartilhar via


Função KsFastPropertyHandler (ks.h)

A função KsFastPropertyHandler lida com solicitações de propriedade rápidas por meio de IOCTL_KS_PROPERTY. Ele responde a todos os identificadores de propriedade 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 KsFastPropertyHandler(
  PFILE_OBJECT         FileObject,
  PKSPROPERTY          Property,
  ULONG                PropertyLength,
  PVOID                Data,
  ULONG                DataLength,
  PIO_STATUS_BLOCK     IoStatus,
  ULONG                PropertySetsCount,
  const KSPROPERTY_SET *PropertySet
);

Parâmetros

FileObject

Property

PropertyLength

Data

DataLength

IoStatus

PropertySetsCount

PropertySet

Valor retornado

A função KsFastPropertyHandler retornará TRUE se a solicitação tiver sido tratada ou FALSE se a solicitação não tiver sido tratada. Se FALSE for retornado, um IRP será gerado. Se a solicitação foi tratada, a função define o elemento IoStatus-Information, por meio da configuração como zero devido a um erro interno ou por meio de um manipulador de propriedades definindo-o>. O manipulador de propriedades também define o campo IoStatus-Status> quando a propriedade é realmente manipulada.

Comentários

O proprietário de um conjunto de propriedades pode executar pré-filtragem ou pós-filtragem da manipulação da propriedade, bem como processar solicitações feitas por meio da interface de expedição de E/S rápida para o controle do dispositivo. A função KsFastPropertyHandler só é usada 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

KsPropertyHandler