FltGetInstanceInformation 関数 (fltkernel.h)

FltGetInstanceInformation ルーチンは、ミニフィルター ドライバー インスタンスに関する情報を返します。

構文

NTSTATUS FLTAPI FltGetInstanceInformation(
  [in]  PFLT_INSTANCE              Instance,
  [in]  INSTANCE_INFORMATION_CLASS InformationClass,
  [out] PVOID                      Buffer,
  [in]  ULONG                      BufferSize,
  [out] PULONG                     BytesReturned
);

パラメーター

[in] Instance

呼び出し元の不透明なインスタンス ポインター。

[in] InformationClass

要求された情報の種類。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
InstanceBasicInformation Buffer パラメーターが指すバッファーは、インスタンスの INSTANCE_BASIC_INFORMATION 構造体を受け取ります。
InstanceFullInformation Buffer パラメーターが指すバッファーは、インスタンスの INSTANCE_FULL_INFORMATION 構造体を受け取ります。
InstancePartialInformation Buffer パラメーターが指すバッファーは、インスタンスの INSTANCE_PARTIAL_INFORMATION 構造体を受け取ります。
InstanceAggregateStandardInformation Buffer パラメーターが指すバッファーは、インスタンスの INSTANCE_AGGREGATE_STANDARD_INFORMATION 構造体を受け取ります。 構造体の LegacyFilter 部分は使用されません。 この構造は、Windows Vista 以降で使用できます。

[out] Buffer

要求された情報を受信する呼び出し元によって割り当てられたバッファーへのポインター。 バッファーで返される情報の型は、InformationClass パラメーターによって定義されます。

[in] BufferSize

Buffer パラメーターが指すバッファーのサイズ (バイト単位)。 呼び出し元は、指定された InformationClass 値に従って、このパラメーターを設定する必要があります。

[out] BytesReturned

バッファー が指すバッファーで返されたバイト数を受け取る呼び出し元によって割り当てられた変数へのポインター BufferSize の入力値が小さすぎる場合、FltGetInstanceInformation はSTATUS_BUFFER_TOO_SMALLを返し、要求された情報を格納するために必要なバイト数にこの変数を設定します。 このパラメーターは必須であり、NULL することはできません。

戻り値

FltGetInstanceInformation 、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターン コード 形容
STATUS_BUFFER_TOO_SMALL
Buffer パラメーターが指すバッファーは、要求された情報を格納するのに十分な大きさではありません。 これはエラー コードです。
STATUS_INVALID_PARAMETER
InformationClass パラメーターに無効な値が指定されました。 たとえば、InstanceAggregateStandardInformation が Windows Vista より前のオペレーティング システムで指定されている場合、ルーチンはSTATUS_INVALID_PARAMETERを返します。 これはエラー コードです。

備考

ミニフィルター インスタンスへのポインターを指定すると、このルーチンはミニフィルター インスタンスに関する情報を返します。 返されるインスタンス情報の種類は、InformationClass パラメーターによって決まります。

必要条件

要件 価値
ターゲット プラットフォーム 万国
ヘッダー fltkernel.h (FltKernel.h を含む)
ライブラリ FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

関連項目

FltEnumerateFilterInformation

FltEnumerateInstanceInformationByFilter

FltEnumerateInstanceInformationByVolume

FltGetFilterInformation

INSTANCE_AGGREGATE_STANDARD_INFORMATION

INSTANCE_BASIC_INFORMATION

INSTANCE_FULL_INFORMATION

INSTANCE_PARTIAL_INFORMATION