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á en 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 de método.

[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 el estado de error y la información.

[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 se controla la solicitud o false si no se controla la solicitud. Si la solicitud no se controla, se genera un IRP. Si se controló la solicitud, la función establece el elemento IoStatus->Information en cero debido a un error interno o el elemento se establece mediante un controlador de métodos. El controlador de métodos también establece el campo IoStatus->Estado cuando se controla el método.

Observaciones

El propietario de un conjunto de métodos puede realizar el prefiltro o postfiltro del control de métodos mediante las funciones de KsFastMethodHandler y KsMethodHandler. La función KsFastMethodHandler se usa para procesar las solicitudes realizadas a través de la interfaz de distribución rápida de E/S para el control de dispositivos. Solo se usa para procesar solicitudes que se pueden cumplir rápidamente. No se pasa el parámetro Wait de la función de E/S rápida y se supone que es TRUE.

Requisitos

Consulte también

KsMethodHandler