Método IWDFIoQueue::ConfigureRequestDispatching (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 ConfigureRequestDispatching configura la puesta en cola de las solicitudes de E/S del tipo especificado.

Sintaxis

HRESULT ConfigureRequestDispatching(
  [in] WDF_REQUEST_TYPE RequestType,
  [in] BOOL             Forward
);

Parámetros

[in] RequestType

Valor WDF_REQUEST_TYPE con tipo que identifica el tipo de solicitud que se va a poner en cola. Los únicos valores válidos son WdfRequestCreate, WdfRequestRead, WdfRequestWrite y WdfRequestDeviceIoControl.

[in] Forward

Valor BOOL que especifica si se ponen en cola las solicitudes del tipo especificado. TRUE indica que se habilitan las solicitudes de puesta en cola; FALSE indica que se deshabilitan las solicitudes de puesta en cola.

Valor devuelto

ConfigureRequestDispatching devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.

Comentarios

El controlador puede llamar al método ConfigureRequestDispatching varias veces para configurar cómo se envía cada tipo de solicitud a la cola de E/S.

Ejemplos

En el ejemplo de código siguiente se muestra cómo configurar el reenvío para las solicitudes IOCTL.

    //
    // Configure forwarding for IOCTL requests
    //
    HRESULT hr = m_FxQueue->ConfigureRequestDispatching(
                                                        WdfRequestDeviceIoControl,
                                                        true
                                                        );

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.5
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFIoQueue

WDF_REQUEST_TYPE