Метод IWDFIoQueue::ConfigureRequestDispatching (wudfddi.h)

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

Метод ConfigureRequestDispatching настраивает очередь запросов ввода-вывода заданного типа.

Синтаксис

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

Параметры

[in] RequestType

WDF_REQUEST_TYPE типизированное значение, определяющее тип запроса для постановки в очередь. Единственными допустимыми значениями являются WdfRequestCreate, WdfRequestRead, WdfRequestWrite и WdfRequestDeviceIoControl.

[in] Forward

Значение BOOL, указывающее, помещаются ли запросы указанного типа в очередь. ЗНАЧЕНИЕ TRUE указывает, что необходимо включить запросы очередей; Значение FALSE указывает на отключение запросов очередей.

Возвращаемое значение

ConfigureRequestDispatching возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Комментарии

Драйвер может несколько раз вызывать метод ConfigureRequestDispatching , чтобы настроить способ отправки каждого типа запроса в очередь ввода-вывода.

Примеры

В следующем примере кода показано, как настроить переадресацию для запросов IOCTL.

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

Требования

См. также раздел

IWDFIoQueue

WDF_REQUEST_TYPE