Método IWDFIoRequest3::SetUserModeDriverInitiatedIo (wudfddi.h)

  • Artículo

[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

Consulte también

GetUserModeDriverInitiatedIo

IWDFIoRequest3

WdfRequestSetUserModeDriverInitiatedIo