REPARSE_GUID_DATA_BUFFER 構造体 (ntifs.h)

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

REPARSE_GUID_DATA_BUFFER構造体には、再解析ポイントの再解析ポイントデータが含まれています。

構文

typedef struct _REPARSE_GUID_DATA_BUFFER {
  ULONG  ReparseTag;
  USHORT ReparseDataLength;
  USHORT Reserved;
  GUID   ReparseGuid;
  struct {
    UCHAR DataBuffer[1];
  } GenericReparseBuffer;
} REPARSE_GUID_DATA_BUFFER, *PREPARSE_GUID_DATA_BUFFER;

メンバー

ReparseTag

再解析ポイントの所有者を一意に識別する再解析ポイントタグ。 (次の 「解説 」セクションを参照してください)。

ReparseDataLength

DataBuffer メンバー内の再解析データのサイズ (バイト単位)。

Reserved

予約済みです。使わないでください。

ReparseGuid

再解析ポイントの所有者を一意に識別する GUID。 (次の 「解説 」セクションを参照してください)。

GenericReparseBuffer

GenericReparseBuffer.DataBuffer[1]

再解析ポイントのユーザー定義データ。このデータの形式は、再解析ポイントの所有者によって定義されます。

注釈

REPARSE_GUID_DATA_BUFFER構造は、すべてのサードパーティのファイルシステム、フィルター、ミニフィルター、および一部の Microsoft ファイルシステム、フィルター、ミニフィルターで使用され、再解析ポイントのデータを格納します。各再解析ポイントには、1 つのREPARSE_GUID_DATA_BUFFER構造体が含まれています。

Microsoft の再解析ポイントでは、 REPARSE_GUID_DATA_BUFFER 構造の代わりに REPARSE_DATA_BUFFER 構造体を使用できます。ただし、REPARSE_GUID_DATA_BUFFER構造を使用するには、サードパーティの再解析ポイントが必要です。

再解析ポイントタグは、 Microsoft によって第三者に割り当てられます。ファイルシステム、ファイルシステムフィルタードライバー、またはミニフィルタードライバーで使用するために、複数の再解析ポイントを要求できます。

再解析ポイント GUID は、Microsoft によって割り当てられない。ただし、割り当てられた再解析ポイントタグで使用する 1 つの GUID を選択する必要があり、この GUID は常にタグと共に使用する必要があります。 GUID を生成するには、MICROSOFT WINDOWS SDKに含まれるツールである GUIDGen (Guidgen.exe) を使用できます。

ミニフィルターは、FltTagFile または FltUntagFile を呼び出すことによって、再解析ポイントを設定または削除できます。ミニフィルターは、 FSCTL_GET_REPARSE_POINT コントロールコードを使用して再解析ポイントを取得できます。このコードは、 FltFsControlFile を呼び出すことによってファイルシステムに送信できます。

ファイルシステムとフィルタードライバーは、FSCTL_GET_REPARSE_POINT、FSCTL_SET_REPARSE_POINT、およびFSCTL_DELETE_REPARSE_POINT コントロールコードを使用して、再解析ポイントを取得、設定、または削除できます。これらのコードは、 ZwFsControlFile を呼び出すことによってファイルシステムに送信できます。

ポイントの再解析と再解析ポイントタグの詳細については、Windows SDK のドキュメントを参照してください。