KsQueryInformationFile 関数 (ks.h)
KsQueryInformationFile 関数は、指定したファイル オブジェクトに対して情報クエリを実行します。 この関数は、可能であれば FastIoDispatch 使用を試みるか、デバイス オブジェクトに対して情報要求を生成します。
構文
KSDDKAPI NTSTATUS KsQueryInformationFile(
[in] PFILE_OBJECT FileObject,
[out] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass
);
パラメーター
[in] FileObject
標準情報の照会元となるファイル オブジェクトを指定します。
[out] FileInformation
ファイル情報を配置する場所を示します。 これは、有効なアドレスまたはプローブされたアドレスであると見なされます。
[in] Length
FileInformation バッファーの正しい長さを指定します。
[in] FileInformationClass
要求される情報のクラスを指定します。
戻り値
KsQueryInformationFile 関数は、成功した場合、または失敗した場合はクエリ エラーを返STATUS_SUCCESSを返します。
備考
KsQueryInformationFile 関数は、クエリによって基になるドライバーへの実際の要求が発生する場合にのみ使用する必要があります。 たとえば、FilePositionInformation はこのような要求を生成せず、使用しないでください。 呼び出し元が、FO_SYNCHRONOUS_IO ファイル オブジェクトに対する操作のためにファイルへのアクセスをシリアル化していることを前提としています。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | 万国 |
ヘッダー | ks.h (Ks.h を含む) |
ライブラリ | Ks.lib |