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 ファイル オブジェクトに対する操作のためにファイルへのアクセスをシリアル化していることを前提としています。

要件