WdfObjectReferenceActual 関数 (wdfobject.h)

[KMDF と UMDF に適用]

WdfObjectReferenceActual メソッドは、指定したフレームワーク オブジェクトの参照カウントをインクリメントし、タグ値、行番号、およびファイル名を参照に割り当てます。

構文

void WdfObjectReferenceActual(
  [in]           WDFOBJECT Handle,
  [in, optional] PVOID     Tag,
  [in]           LONG      Line,
  [in]           PCCH      File
);

パラメーター

[in] Handle

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

[in, optional] Tag

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

[in] Line

ドライバー ソース ファイル内の行番号を表す数値。

[in] File

ドライバー ソース ファイルの名前を表す null で終わる定数文字列へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

なし

解説

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

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

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

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

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

フレームワーク オブジェクト階層のクリーンアップ規則の詳細については、「 フレームワーク オブジェクトのライフ サイクル」を参照してください。

例

次のコード例では、オブジェクトの参照カウントをインクリメントし、タグ値、行番号、およびファイル名を参照に割り当てます。

WdfObjectReferenceActual(
                         object,
                         pTag,
                         line,
                         FILE_NAME
                         );

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfobject.h (Wdf.h を含む)
Library	Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf)

こちらもご覧ください

WdfObjectReference