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 値を返します。
リターン コード | 形容 |
---|---|
|
Buffer パラメーターが指すバッファーは、要求された情報を格納するのに十分な大きさではありません。 これはエラー コードです。 |
|
InformationClass パラメーターに無効な値が指定されました。 たとえば、InstanceAggregateStandardInformation が Windows Vista より前のオペレーティング システムで指定されている場合、ルーチンはSTATUS_INVALID_PARAMETERを返します。 これはエラー コードです。 |
ミニフィルター インスタンスへのポインターを指定すると、このルーチンはミニフィルター インスタンスに関する情報を返します。 返されるインスタンス情報の種類は、InformationClass パラメーターによって決まります。
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | 万国 |
ヘッダー | fltkernel.h (FltKernel.h を含む) |
ライブラリ | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |
FltEnumerateFilterInformation の
FltEnumerateInstanceInformationByFilter の
FltEnumerateInstanceInformationByVolume の
FltGetFilterInformation の