ObfReferenceObject 関数 (wdm.h)
ObfReferenceObject ルーチンは、指定されたオブジェクトに対して参照カウントをインクリメントします。
構文
LONG_PTR ObfReferenceObject(
[in] PVOID Object
);
パラメーター
[in] Object
オブジェクトへのポインター。 呼び出し元は、オブジェクトを作成したとき、またはオブジェクトを開いた後の ObReferenceObjectByHandle の前の呼び出しから、このパラメーターを取得しました。
戻り値
ObfReferenceObject は、システム使用のために予約されている値を返します。 ドライバーは、この値を VOID として扱う必要があります。
注釈
ObfReferenceObject は 、 ObReferenceObjectByHandle および ObReferenceObjectByPointer のように、指定されたオブジェクトに対するアクセス チェックを行わずに、オブジェクト の ポインター参照カウントをインクリメントするだけです。
ObfReferenceObject は、少なくとも、ドライバーがその後、その逆数 ObDereferenceObject を呼び出すか、指定されたオブジェクトを閉じるまで、オブジェクトの削除を防ぎます。 呼び出し元は、オブジェクトで完了したらすぐに ObDereferenceObject を使用して参照カウントをデクリメントする必要があります。
オブジェクトの参照カウントが 0 に達すると、カーネル モード コンポーネントはシステムからオブジェクトを削除できます。 ただし、ドライバーは、作成したオブジェクトのみを削除できます。また、ドライバーが作成しなかったオブジェクトを削除しようとしないでください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), TargetRelationNeedsRef(wdm) |