Función KsFastMethodHandler (ks.h)
La función KsFastMethodHandler controla los métodos rápidos solicitados a través de IOCTL_KS_METHOD. Responde a todos los identificadores de método 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 KsFastMethodHandler(
[in] PFILE_OBJECT FileObject,
[in] PKSMETHOD Method,
[in] ULONG MethodLength,
[in, out] PVOID Data,
[in] ULONG DataLength,
[out] PIO_STATUS_BLOCK IoStatus,
[in] ULONG MethodSetsCount,
[in] const KSMETHOD_SET *MethodSet
);
Parámetros
[in] FileObject
Especifica el objeto de archivo en el que se realizó la solicitud.
[in] Method
Especifica el parámetro de método original. Esto siempre estará activado FILE_LONG_ALIGNMENT, pero puede que no esté en FILE_QUAD_ALIGNMENT.
[in] MethodLength
Especifica la longitud indicada por el autor de la llamada del parámetro method.
[in, out] Data
Especifica el parámetro de datos no asignado original.
[in] DataLength
Especifica la longitud indicada por el autor de la llamada del parámetro de datos.
[out] IoStatus
Especifica una estructura alineada que se usa para devolver información y estado de error.
[in] MethodSetsCount
Indica el número de estructuras de conjunto de métodos que se pasan.
[in] MethodSet
Especifica el puntero a la lista de información del conjunto de métodos.
Valor devuelto
La función KsFastMethodHandler devuelve TRUE si la solicitud se controla o FALSE si la solicitud no se controla. Si la solicitud no se controla, se genera un IRP. Si se ha controlado la solicitud, la función establece el elemento IoStatus-Information> en cero debido a un error interno o el elemento lo establece un controlador de métodos. El controlador de métodos también establece el campo IoStatus-Status> cuando se controla el método.
Comentarios
El propietario de un conjunto de métodos puede realizar el filtrado previo o postfiltro del control de métodos mediante las funciones KsFastMethodHandler y KsMethodHandler . La función KsFastMethodHandler se usa para procesar las solicitudes realizadas a través de la interfaz de distribución de E/S rápida para el control de dispositivos. Solo se usa para procesar las solicitudes que se pueden cumplir 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 (incluya Ks.h) |
| Library | Ks.lib |