次の方法で共有


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