次の方法で共有


WdfObjectDereference マクロ

[KMDF と UMDF に適用]

WdfObjectDereference マクロは、指定されたフレームワーク オブジェクトの参照カウントをデクリメントします。

構文

VOID WdfObjectDereference(
  [in] WDFOBJECT Handle
);

パラメーター

ハンドル [入力]
フレームワークオブジェクトへのハンドル。

戻り値

ありません。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

解説

オブジェクトの参照カウントが 0 になると WdfObjectDereference が返される前にオブジェクトが削除される可能性があります。

ドライバーは WdfObjectReference を以前に呼び出した場合にのみ、WdfObjectDereference を呼び出すことができます。

ドライバーは WdfObjectDereferenceを呼び出す代わりに、WdfObjectDereferenceWithTag または WdfObjectDereferenceActual を呼び出すことができます。

オブジェクト参照カウントの詳細については、「フレームワーク オブジェクトのライフ サイクル」をご参照ください。

次のコード例では、オブジェクトの参照カウントをデクリメントします。

WdfObjectDereference(Object); 

要件

対象プラットフォーム

ユニバーサル

KMDF の最小バージョン

1.0

UMDF の最小バージョン

2.0

ヘッダー

Wdfobject.h (Wdf.h を含む)

ライブラリ

Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)

IRQL

<= DISPATCH_LEVEL

DDI 準拠の規則

DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest

関連項目

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference