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