WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME函式 (wdfiotarget.h)
[適用於 KMDF 和 UMDF]
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME函式會初始化驅動程式的WDF_IO_TARGET_OPEN_PARAMS結構，讓驅動程式可以藉由指定裝置、檔案或裝置介面的名稱來開啟 I/O 目標。 如果提供的名稱不存在，系統將不會嘗試建立它。
語法
void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
[out] PWDF_IO_TARGET_OPEN_PARAMS Params,
[in] PCUNICODE_STRING TargetDeviceName,
[in] ACCESS_MASK DesiredAccess
);
參數
[out] Params
函式初始化的驅動程式配置 WDF_IO_TARGET_OPEN_PARAMS 結構的指標。
[in] TargetDeviceName
WDF_IO_TARGET_OPEN_PARAMS 結構的 TargetDeviceName 成員值。
[in] DesiredAccess
WDF_IO_TARGET_OPEN_PARAMS 結構的 DesiredAccess 成員值。
傳回值
無
備註
如果 TargetDeviceName 指定已經存在的檔名，系統就會開啟現有的檔案。 如果檔案不存在，開啟作業就會失敗。
WDF_IO_TARGET_OPEN_PARAMS 結構會做為 WdfIoTargetOpen 方法的輸入。
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME函式會初始化指定之WDF_IO_TARGET_OPEN_PARAMS結構的 Size、Type、TargetDeviceName、DesiredAccess、CreateOptions 和 CreateDisposition 成員。
KMDF WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME函式會將 CreateDisposition 成員初始化為 FILE_OPEN。
UMDF WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME函式會將 CreateDisposition 成員初始化為 OPEN_EXISTING。
如需 I/O 目標的詳細資訊，請參閱 使用 I/O 目標。
範例
如需使用 WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 的程式代碼範例，請參閱 WdfIoTargetOpen。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最小 KMDF 版本 | 1.0 |
| 最低UMDF版本 | 2.0 |
| 標頭 | wdfiotarget.h (包含 Wdf.h) |
| IRQL | 任何層級 |
另請參閱
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME