Método IQueueCallbackDeviceIoControl::OnDeviceIoControl (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.

Se llama al método OnDeviceIoControl para controlar una solicitud de control de E/S de dispositivo cuando una aplicación realiza una operación específica en un dispositivo a través de la función OnDeviceIoControl de Microsoft Win32.

Sintaxis

void OnDeviceIoControl(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] ULONG         ControlCode,
       SIZE_T        InputBufferSizeInBytes,
       SIZE_T        OutputBufferSizeInBytes
);

Parámetros

[in] pWdfQueue

Puntero a la interfaz IWDFIoQueue del objeto de cola de E/S desde el que llega la solicitud.

[in] pWdfRequest

Puntero a la interfaz IWDFIoRequest que representa el objeto de solicitud de marco.

[in] ControlCode

Código de control de E/S definido por el controlador o definido por el sistema (IOCTL) que identifica la operación específica que se va a realizar y que está asociada a la solicitud.

InputBufferSizeInBytes

Tamaño, en bytes, del búfer de entrada de la solicitud.

OutputBufferSizeInBytes

Tamaño, en bytes, del búfer de salida de la solicitud.

Valor devuelto

None

Observaciones

Un controlador registra la interfaz IQueueCallbackDeviceIoControl cuando el controlador llama al método IWDFDevice::CreateIoQueue para crear una cola de E/S o para configurar la cola de E/S predeterminada.

Un controlador puede implementar un único método OnDeviceIoControl para todas las colas de E/S o métodos OnDeviceIoControl independientes para cada cola de E/S.

El método OnDeviceIoControl recibe cada tipo de solicitud de control de E/S de dispositivo de una cola. (El tipo de solicitud se identifica mediante el valor WdfRequestDeviceIoControl del tipo de enumeración WDF_REQUEST_TYPE para la solicitud).

Para obtener más información sobre los métodos del controlador que están asociados a colas y que el marco llama, consulte Funciones de devolución de llamada de eventos de cola de E /S. El método OnDeviceIoControl debe procesar cada solicitud de control de E/S de dispositivo recibida. Para obtener más información sobre cómo los controladores de UMDF procesan las solicitudes de E/S, consulte Procesamiento de solicitudes de E/S.

El controlador puede llamar a los métodos IWDFIoRequest::GetDeviceIoControlParameters, IWDFIoRequest::GetInputMemory e IWDFIoRequest::GetOutputMemory para recuperar información sobre la solicitud y los búferes de entrada y salida.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado wudfddi.h (incluya Wudfddi.h)

Consulte también