WdfObjectReference マクロ

[KMDF と UMDF に適用]

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

構文

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

パラメーター

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

戻り値

なし。

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

注釈

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

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

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

例示

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

WdfObjectReference(Object); 

必要条件

こちらもご覧ください

WdfObjectReferenceActualの

WdfObjectReferenceWithTagの