WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN 函数 (wdfiotarget.h)

项目
02/27/2024

[适用于 KMDF 和 UMDF]

WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN 函数初始化驱动程序的 WDF_IO_TARGET_OPEN_PARAMS 结构，以便驱动程序可以重新打开远程 I/O 目标。

语法

void WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN(
  [out] PWDF_IO_TARGET_OPEN_PARAMS Params
);

参数

[out] Params

指向驱动程序分配的WDF_IO_TARGET_OPEN_PARAMS 结构的指针，该结构由函数初始化。

返回值

无

备注

WDF_IO_TARGET_OPEN_PARAMS 结构用作 WdfIoTargetOpen 方法的输入。如果驱动程序从 EvtIoTargetRemoveCanceled 回调函数中调用 WdfIoTargetOpen，则驱动程序应调用 WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN 来初始化 WDF_IO_TARGET_OPEN_PARAMS 结构。

WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN 函数将指定的WDF_IO_TARGET_OPEN_PARAMS结构归零，并设置结构的 Size 成员。然后，函数将 Type 成员设置为 WdfIoTargetOpenReopen。

有关 I/O 目标的详细信息，请参阅使用 I/O 目标。

示例

下面的代码示例是重新打开远程 I/O 目标的 EvtIoTargetRemoveCanceled 回调函数的段。

VOID
MyEvtIoTargetRemoveCanceled(
    WDFIOTARGET IoTarget
    )
{
    WDF_IO_TARGET_OPEN_PARAMS openParams;
    NTSTATUS status;

...
    WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN(&openParams);
    status = WdfIoTargetOpen(
                             IoTarget,
                             &openParams
                             );
...
}