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 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 |