SECTION_OBJECT_POINTERS 構造体 (wdm.h)

[アーティクル]
03/08/2023

ファイルシステムまたはリダイレクタードライバーによって割り当てられた SECTION_OBJECT_POINTERS 構造は、ファイルストリームのファイルマッピングとキャッシュ関連情報を格納するためにメモリマネージャーとキャッシュマネージャーによって使用されます。

構文

typedef struct _SECTION_OBJECT_POINTERS {
  PVOID DataSectionObject;
  PVOID SharedCacheMap;
  PVOID ImageSectionObject;
} SECTION_OBJECT_POINTERS;

メンバー

DataSectionObject

データファイルストリームの状態情報を追跡するために使用されるデータセクションオブジェクト ( つまり、CONTROL_AREA 構造体) への不透明なポインター。メモリマネージャーは、オペレーティングシステムが最初にデータストリームをキャッシュするときに、このメンバーを設定します。 NULL 値は、データストリームが現在メモリ内にないことを示します。ただし、この値はいつでも変更できます。

SharedCacheMap

データファイルストリームにマップされたビューを追跡するために使用されるキャッシュマップオブジェクト ( つまり、SHARED_CACHE_MAP 構造体) への不透明なポインター。キャッシュマネージャーは、オペレーティングシステムがストリームを最初にキャッシュするときに、このメンバーを設定します。 NULL 値は、データストリームが現在キャッシュされていないことを示します。ただし、この値はいつでも変更できます。

ImageSectionObject

実行可能ファイルストリームの状態情報を追跡するために使用されるイメージセクションオブジェクト ( つまり、CONTROL_AREA 構造体) への不透明なポインター。メモリマネージャーは、ストリームの実行可能イメージセクションが作成されるたびに、このメンバーを設定します。 NULL 値は、実行可能イメージが現在メモリ内にないことを示します。ただし、この値はいつでも変更できます。

注釈

SECTION_OBJECT_POINTERS構造体は、ファイルオブジェクトをファイルストリームのセクションオブジェクトにリンクします。つまり、そのメンバーを介して、 SECTION_OBJECT_POINTERS 構造体は、特定のファイルオブジェクトを仮想メモリ制御構造体に接続します。これにより、ストリームの内容がメモリ内にあるときに追跡され、存在しないときにオペレーティングシステムがそれらの内容をフェッチできるようになります。

SECTION_OBJECT_POINTERS構造体とファイルストリームの間には、1 対 1 のリレーションシップがあります。複数のファイルオブジェクトを特定のファイルストリームに関連付けることができ、それぞれがストリームの開いているインスタンスを表します。ただし、特定のストリームに関連付けることができる SECTION_OBJECT_POINTERS 構造体は 1 つだけです。ストリームに複数のファイルオブジェクトがある場合、すべてのファイルオブジェクトの SectionObjectPointer メンバーは、同じ SECTION_OBJECT_POINTERS 構造 (ストリームに関連付けられている) を指す必要があります。

最初のファイルストリームオープン要求の場合、ファイルシステムまたはリダイレクタードライバーは次の手順を実行する必要があります。

非ページプールから SECTION_OBJECT_POINTERS 構造体を割り当てます。
割り当てられた SECTION_OBJECT_POINTERS 構造体のすべてのメンバーを NULL に初期化 します。
初期化されたSECTION_OBJECT_POINTERS構造体を指す関連付けファイルオブジェクトの SectionObjectPointer メンバーを設定します。

同じファイルストリームに対する後続のオープン要求の場合、ファイルシステムまたはリダイレクタードライバーは、関連付けられたファイルオブジェクトの SectionObjectPointer メンバーを、以前に割り当てられたファイルストリーム のSECTION_OBJECT_POINTERS 構造体を指すよう設定する必要があります。

警告

ファイルシステムフィルタードライバーは、基になるファイルシステムがメンバーの同期を担当するため、 SECTION_OBJECT_POINTERS 構造体のメンバーを不透明として扱う必要があります。したがって、いつでも値を変更できます。

ファイルは、ファイルシステムに応じて 1 つ以上のストリームで構成されます。詳細については、「ファイルストリーム」、「Stream コンテキスト」、「Per-Stream コンテキスト」を参照してください。