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 |