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 函数初始化 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。

要求

另请参阅

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetOpen