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 controladores UMDF nuevos deben escribirse con 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 con UMDF.
El 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 viniera de un controlador UMDF.
Sintaxis
void SetUserModeDriverInitiatedIo(
[in] BOOL IsUserModeDriverInitiated
);
Parámetros
[in] IsUserModeDriverInitiated
Valor booleano que, si es TRUE, indica que la solicitud se debe tratar como si fuera iniciada por un controlador UMDF. Si es FALSE, este parámetro indica que la solicitud debe tratarse como si procede 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 archivo o un destino de E/S win32.
Un controlador UMDF podría establecer el parámetro IsUserModeDriverInitiated enTRUE 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.
El equivalente UMDF 2 de este método es WdfRequestSetUserModeDriverInitiatedIo.
Requisitos
| Requisito | Value |
|---|---|
| Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Versión mínima de UMDF | 1.11 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |