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

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	ks.h (Ks.h を含む)
ライブラリ	Ks.lib