WdfObjectReference マクロ

[KMDF と UMDF に適用]

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

構文

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

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

ありません。

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

ドライバーが WdfObjectReference を呼び出して参照カウントをインクリメントする場合、ドライバーは WdfObjectDereference を呼び出してカウントを減らす必要があります。

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

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

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

WdfObjectReference(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