WdfDeviceInitFree 関数 (wdfdevice.h)

[KMDF にのみ適用]

WdfDeviceInitFree メソッドは、WDFDEVICE_INIT構造体の割り当てを解除します。

構文

void WdfDeviceInitFree(
  [in] PWDFDEVICE_INIT DeviceInit
);

パラメーター

[in] DeviceInit

WDFDEVICE_INIT構造体へのポインター。

戻り値

なし

解説

ドライバーが WdfPdoInitAllocate または WdfControlDeviceInitAllocate の呼び出しからWDFDEVICE_INIT構造を受け取り、デバイス オブジェクト初期化メソッドまたは WdfDeviceCreate を呼び出したときにドライバーでエラーが発生した場合、ドライバーは WdfDeviceInitFree を呼び出す必要があります。

WdfDeviceCreate が正常に呼び出された後、ドライバーは WdfDeviceInitFree を呼び出してはなりません。

ドライバーは、コールバック関数が返された後にフレームワークによって構造体が削除されるため、WDFDEVICE_INIT構造体を EvtDriverDeviceAdd コールバック関数への入力として受け取った場合、WdfDeviceInitFree を呼び出す必要はありません。

WdfDeviceCreate の呼び出しの詳細については、「Framework デバイス オブジェクトの作成」を参照してください。

例

次のコード例では、 WdfPdoInitAssignRawDevice の呼び出しが失敗した場合に WdfDeviceInitFree を 呼び出します。

NTSTATUS  status;

status = WdfPdoInitAssignRawDevice(
                                   pDeviceInit,
                                   &GUID_DEVCLASS_KEYBOARD
                                   );
if (!NT_SUCCESS(status)) {
    WdfDeviceInitFree(pDeviceInit);
    pDeviceInit = NULL;
    return STATUS;
}

要件

こちらもご覧ください

WdfDeviceCreate