Метод 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