Función WdfRequestSetUserModeDriverInitiatedIo (wdfrequest.h)

  • Artículo

[Solo se aplica a UMDF]

El método WdfRequestSetUserModeDriverInitiatedIo indica a los controladores en modo kernel que se encuentran debajo del controlador UMDF en la misma pila de dispositivos que se debe tratar una solicitud determinada como si viniera de un controlador UMDF.

Sintaxis

void WdfRequestSetUserModeDriverInitiatedIo(
  [in] WDFREQUEST Request,
  [in] BOOLEAN    IsUserModeDriverInitiated
);

Parámetros

[in] Request

Identificador de un objeto de solicitud de marco.

[in] IsUserModeDriverInitiated

Valor booleano que, si es TRUE, indica que la solicitud debe tratarse como si se iniciara mediante un controlador UMDF. Si es FALSE, este parámetro indica que la solicitud debe tratarse como si fuera de una aplicación.

Valor devuelto

None

Observaciones

Si un controlador UMDF llama a este método con el parámetro IsUserModeDriverInitiated establecido en TRUE, el marco establece la marca IRP_UM_DRIVER_INITIATED_IO en el miembro Flags de la estructura IRP de WDM antes de reenviar la solicitud a controladores en modo kernel.

Un controlador en modo kernel que reside debajo del controlador UMDF en la misma pila de dispositivos puede comprobar esta marca para determinar si la solicitud debe tratarse como si se iniciara por un controlador UMDF.

Esta marca no es aplicable a los controladores en modo kernel que pueden recibir una solicitud de un controlador UMDF a través de un destino de E/S de identificador de archivos o un destino de E/S de Win32.

Un controlador UMDF podría establecer el parámetro IsUserModeDriverInitiated en TRUE para una solicitud procedente de una aplicación si el controlador ha validado la solicitud.

Las solicitudes que el controlador creado por sí mismo ya están marcados como que se han originado en un controlador UMDF.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1
Plataforma de destino Universal
Versión mínima de UMDF 2.0
Encabezado wdfrequest.h (incluir Wdf.h)
Library WUDFx02000.lib; WUDFx02000.dll
IRQL PASSIVE_LEVEL

Consulte también

WdfRequestGetUserModeDriverInitiatedIo