Função KsFastPropertyHandler (ks.h)
A função KsFastPropertyHandler manipula 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 de retorno
A função KsFastPropertyHandler retorna verdadeiro se a solicitação foi tratada ou FALSE se a solicitação não foi tratada. Se FALSE for retornado, um IRP será gerado. Se a solicitação tiver sido tratada, a função definirá o elemento IoStatus->Information, por meio da configuração como zero devido a um erro interno ou por meio de um manipulador de propriedades que o definiu. O manipulador de propriedades também define o campo Status de>IoStatus quando a propriedade é realmente manipulada.
Observações
O proprietário de um conjunto de propriedades pode executar pré-filtragem ou pós-filtragem do tratamento da propriedade, bem como processar solicitações feitas por meio da interface de expedição de E/S rápida para controle de 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 supõe-se que seja verdadeiro.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |