WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN関数 (wdfiotarget.h)

[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
                             );
...
}

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfiotarget.h (Wdf.h を含む)
IRQL 任意のレベル

こちらもご覧ください

EvtIoTargetRemoveCanceled

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetOpen

WdfIoTargetOpenReopen