WdfObjectReferenceWithTag マクロ

[KMDF と UMDF に適用]

WdfObjectReferenceWithTag マクロは、指定されたフレームワーク オブジェクトの参照カウントをインクリメントし、ドライバーの現在のファイル名と行番号を参照に割り当てます。 マクロは、参照にタグ値も割り当てられます。

構文

VOID WdfObjectReferenceWithTag(
  [in] WDFOBJECT Handle,
  [in] PVOID     Tag
);

パラメーター

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

タグ [in]
フレームワークがオブジェクト参照の識別タグとして格納するドライバー定義の値。

戻り値

ありません。

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

解説

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

WdfObjectReference の代わりに WdfObjectReferenceActual または WdfObjectReferenceWithTag を呼び出すと、Microsoft デバッガーに追加情報 (タグ値、行番号、ファイル名) が提供されます。 WdfObjectReferenceActual を使用すると、ドライバーで行番号とファイル名を指定できます。一方、WdfObjectReferenceWithTag はドライバーの現在の行番号とファイル名を使用します。

!wdftagtracker デバッガー拡張機能を使用して、タグ、行番号、およびファイル名の値を表示できます。 デバッガー拡張機能は、ポインターと一連の文字の両方としてタグ値を表示します。 デバッガー拡張機能の詳細については、「KMDF ドライバーのデバッグ」をご参照ください。

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

例

次のコード例では、オブジェクトの参照カウントをインクリメントし、タグ値を参照に割り当てます。

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

要件

対象プラットフォーム	ユニバーサル
KMDF の最小バージョン	1.0
UMDF の最小バージョン	2.0
ヘッダー	Wdfobject.h (Wdf.h を含む)
ライブラリ	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL

関連項目

WdfObjectReference