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 |