KsSetInformationFile 関数 (ks.h)

KsSetInformationFile 関数は、指定されたファイル オブジェクトに対して情報セットを実行します。 この関数は、可能であれば FastIoDispatch の使用を試みます。または、デバイス オブジェクトに対して設定された情報を生成します。

構文

KSDDKAPI NTSTATUS KsSetInformationFile(
  [in] PFILE_OBJECT           FileObject,
  [in] PVOID                  FileInformation,
  [in] ULONG                  Length,
  [in] FILE_INFORMATION_CLASS FileInformationClass
);

パラメーター

[in] FileObject

標準情報を設定するファイル オブジェクトを指定します。

[in] FileInformation

ファイル情報を配置する場所を示します。 ファイル情報は、有効なアドレスまたはプローブされたアドレスであると見なされます。

[in] Length

FileInformation バッファーの正しい長さを指定します。

[in] FileInformationClass

設定する情報のクラスを指定します。

戻り値

KsSetInformationFile 関数は、成功した場合はSTATUS_SUCCESSを返すか、失敗した場合はセット エラーを返します。

注釈

KsSetInformationFile 関数は、セットによって基になるドライバーに対する実際の要求が発生する場合にのみ使用する必要があります。これには、名前変更、削除、完了などの追加パラメーターをドライバーに送信する必要がある複雑な操作は含まれません。 たとえば、 FilePositionInformation はこのような要求を生成せず、使用しないでください。 呼び出し元が、FO_SYNCHRONOUS_IO ファイル オブジェクトに対する操作のためにファイルへのアクセスをシリアル化していることを前提としています。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ks.h (Ks.h を含む)
Library	Ks.lib