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

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetOpen