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 目標。

範例

下列程式代碼範例是 EvtIoTargetRemoveCanceled 回呼函式的區段，可重新開啟遠端 I/O 目標。

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

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