Función KsFastPropertyHandler (ks.h)
La función KsFastPropertyHandler controla las solicitudes de propiedades rápidas a través de IOCTL_KS_PROPERTY. Responde a todos los identificadores de propiedad definidos por los conjuntos que también están incluidos en la lista de E/S rápida. Solo se puede llamar a esta función en PASSIVE_LEVEL.
Sintaxis
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 devuelto
La función KsFastPropertyHandler devuelve TRUE si la solicitud se controló o FALSE si la solicitud no se controló. Si se devuelve FALSE , se genera un IRP. Si se ha controlado la solicitud, la función establece el elemento IoStatus-Information>, ya sea estableciendo en cero debido a un error interno o a través de un controlador de propiedades que lo establece. El controlador de propiedades también establece el campo IoStatus-Status> cuando la propiedad se controla realmente.
Comentarios
El propietario de un conjunto de propiedades puede realizar el filtrado previo o el posfiltro del control de propiedades, así como procesar las solicitudes realizadas a través de la interfaz de distribución de E/S rápida para el control de dispositivos. La función KsFastPropertyHandler solo se usa para procesar solicitudes que se pueden satisfacer rápidamente. El parámetro Wait de la función de E/S rápida no se pasa y se supone que es TRUE.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluye Ks.h) |
| Library | Ks.lib |