WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 函数 (wdfiotarget.h)

项目
02/27/2024

[适用于 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 目标。