共用方式為

IWDFIoQueue：：ConfigureRequestDispatching 方法 （wudfddi.h）

  • 發行項

[警告： UMDF 2 是最新版本的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上對 UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱 開始使用 UMDF。]

ConfigureRequestDispatching 方法會設定指定類型的 I/O 要求的佇列。

語法

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 方法多次，以設定如何將每個要求類型分派至 I/O 佇列。

例子

下列程式代碼範例示範如何設定IOCTL要求的轉送。

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

要求

要求 價值
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平臺 桌面
最低 UMDF 版本 1.5
標頭 wudfddi.h （包括 Wudfddi.h）
DLL WUDFx.dll

另請參閱

IWDFIoQueue

WDF_REQUEST_TYPE