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

TargetDeviceNameWDF_IO_TARGET_OPEN_PARAMS 結構成員的值。

[in] DesiredAccess

DesiredAccess 結構成員 WDF_IO_TARGET_OPEN_PARAMS 的值。

返回值

沒有

備註

如果 TargetDeviceName 指定已經存在的檔名，系統就會開啟現有的檔案。 如果檔案不存在，則開啟作業會失敗。

WDF_IO_TARGET_OPEN_PARAMS 結構會作為 WdfIoTargetOpen 方法的輸入。

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 函式會初始化 Size、Type、TargetDeviceName、DesiredAccess、CreateOptions，以及 CreateDisposition 指定之 WDF_IO_TARGET_OPEN_PARAMS 結構的成員。

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。

需求

要求	價值
目標平臺	普遍
最低 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