Método IWDFIoRequest3::SetUserModeDriverInitiatedIo (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
Método SetUserModeDriverInitiatedIo
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 procede de un controlador UMDF.
Sintaxis
void SetUserModeDriverInitiatedIo(
[in] BOOL IsUserModeDriverInitiated
);
Parámetros
[in] IsUserModeDriverInitiated
Valor booleano que, si TRUE, indica que la solicitud debe tratarse como si se iniciara mediante un controlador UMDF. Si FALSE, este parámetro indica que la solicitud debe tratarse como si procede de una aplicación.
Valor devuelto
Ninguno
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 miembro de WDM IRP 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 mediante un controlador UMDF.
Esta marca no es aplicable a los controladores en modo kernel que podrían recibir una solicitud de un controlador UMDF a través de un destino de E/S de identificador de archivo o un destino de E/S win32.
Un controlador UMDF podría establecer el parámetro IsUserModeDriverInitiated en TRUE para una solicitud que provenía 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 originados por un controlador UMDF.
El equivalente UMDF 2 de este método es WdfRequestSetUserModeDriverInitiatedIo.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.11 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |