Método IWDFIoQueue::ConfigureRequestDispatching (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.]
El método ConfigureRequestDispatching configura la puesta en cola de solicitudes de E/S del tipo especificado.
Sintaxis
HRESULT ConfigureRequestDispatching(
[in] WDF_REQUEST_TYPE RequestType,
[in] BOOL Forward
);
Parámetros
[in] RequestType
Valor de tipo WDF_REQUEST_TYPEque identifica el tipo de solicitud que se va a poner en cola. Los únicos valores válidos son WdfRequestCreate, WdfRequestRead, WdfRequestWritey 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.
Observaciones
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 | 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.5 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |