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 |