WdfDeviceInitSetIoTypeEx 函式 (wdfdevice.h)

發行項
02/27/2024

[適用於 KMDF 和 UMDF]

WdfDeviceInitSetIoTypeEx 方法會設定驅動程式如何存取讀取和寫入要求中包含的數據緩衝區，以及指定裝置的裝置 I/O 控制要求的方法或喜好設定。

語法

void WdfDeviceInitSetIoTypeEx(
  [in] PWDFDEVICE_INIT     DeviceInit,
  [in] PWDF_IO_TYPE_CONFIG IoTypeConfig
);

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in] IoTypeConfig

使用 WDF_IO_TYPE_CONFIG_INIT 宏初始化之WDF_IO_TYPE_CONFIG 結構的指標。

傳回值

無

備註

如果您使用 KMDF 1.11 版或更早版本撰寫驅動程式，則必須改用 WdfDeviceInitSetIoType。

KMDF KMDF 驅動程式會呼叫 WdfDeviceInitSetIoTypeEx 來設定讀取和寫入要求的緩衝區存取方法。針對裝置 I/O 控制要求，架構會使用 I/O 控件程式代碼中編碼的緩衝區類型， (IOCTL) 。

UMDF UMDF 驅動程式會呼叫 WdfDeviceInitSetIoTypeEx 來註冊讀取和寫入要求的喜好設定，以及裝置 I/O 控制要求。 UMDF 驅動程式提供給 WdfDeviceInitSetIoTypeEx 的值只是喜好設定，而且不保證架構會使用。您的驅動程式可以呼叫 WdfDeviceGetDeviceStackIoType 來判斷 UMDF 指派給裝置讀取/寫入要求和 I/O 控制要求的緩衝區存取方法。對於 I/O 控制要求，架構使用的存取方法可能與 IOCTL 中指定的存取方法與驅動程式所要求的訪問方法不同。

如果驅動程式呼叫 WdfDeviceInitSetIoTypeEx，它必須先這麼做，才能呼叫 WdfDeviceCreate。

如果驅動程式未呼叫 WdfDeviceInitSetIoTypeEx，架構會將驅動程式的 buffer-access 方法設定為所指定裝置的 WdfDeviceIoBuffered。

從 KMDF 篩選驅動程式呼叫 WdfDeviceInitSetIoTypeEx 沒有任何作用。針對 KMDF 篩選驅動程式，架構會使用驅動程式堆疊中下一個較低驅動程式所指定的 I/O 類型。

不過，UMDF 篩選驅動程式可以藉由呼叫 WdfDeviceInitSetIoTypeEx 來註冊緩衝區存取方法的喜好設定。

驅動程式堆疊中的所有 UMDF 驅動程式都必須使用相同的方法來存取裝置的緩衝區。如果 UMDF 判斷某些驅動程式偏好緩衝 I/O 或裝置的直接 I/O，而其他驅動程式則只偏好緩衝處理裝置的 I/O，UMDF 會針對所有驅動程式使用緩衝 I/O。如果一或多個堆疊的驅動程式只偏好緩衝 I/O，而其他驅動程式則只偏好直接 I/O，UMDF 會將事件記錄到系統事件記錄檔，而不會啟動驅動程式堆疊。

如需緩衝區存取方法的詳細資訊，請參閱存取數據緩衝區。

這個方法相當於 IWDFDeviceInitialize2：：SetIoTypePreference 的 UMDF 2.0。

範例

下列程式代碼範例會初始化 WDF_IO_TYPE_CONFIG 結構、將驅動程式的緩衝區存取喜好設定設定設為直接 I/O、指定傳輸應該使用緩衝 I/O，以及呼叫 WdfDeviceInitSetIoTypeEx。

WDF_IO_TYPE_CONFIG ioConfig;
WDF_IO_TYPE_CONFIG_INIT(&ioConfig);
ioConfig.ReadWriteIoType = WdfDeviceIoDirect;
ioConfig.DeviceControlIoType = WdfDeviceIoDirect;
ioConfig.DirectTransferThreshold = 32;

WdfDeviceInitSetIoTypeEx(DeviceInit, &ioConfig);
}

規格需求

需求	值
目標平台	Universal
最低 KMDF 版本	1.13
最低UMDF版本	2.0
標頭	wdfdevice.h (包含 Wdf.h)
程式庫	Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL