IRP_MJ_SET_INFORMATION
デバイス ドライバーは、必要に応じて IRP_MJ_SET_INFORMATION 要求を処理できます。
送信時
オペレーティング システムが、ファイルまたはファイル ハンドルに関するメタデータを設定するために、IRP_MJ_SET_INFORMATION 要求を送信します。 たとえば、ドライバーが ZwSetInformationFile を呼び出したときに、オペレーティング システムは IRP_MJ_SET_INFORMATION 要求を送信します。
入力パラメーター
Parameters.SetFile.FileInformationClass メンバーは、設定するメタデータの種類を指定する FILE_INFORMATION_CLASS 定数です。 メタデータの種類の詳細については、「ZwSetInformationFile」の FileInformationClass パラメーターを参照してください。
Parameters.SetFile.Length メンバーは、AssociatedIrp.SystemBuffer メンバーが指すバッファーの長さを指定します。
AssociatedIrp.SystemBuffer は、新しい情報設定を含むバッファーを指します。 Parameters.SetFile.FileInformationClass の値によって、返されるデータの形式 (FILE_XXX_INFORMATION 構造体) が決まります。 メタデータの形式の詳細については、「FILE_INFORMATION_CLASS 列挙体」を参照してください。
出力パラメーター
なし
操作
ドライバーは、はこの要求を処理する必要はありません。また、ドライバーが処理する場合でも、Parameters.SetFile.FileInformationClass のすべての可能な値を処理する必要はありません。 ドライバーのディスパッチ ルーチンは、処理しない値に対して STATUS_INVALID_DEVICE_REQUEST などのエラー コードを返す必要があります。
FILE_INFORMATION_CLASS の可能なすべての値が発生するわけではありません。
要件
ヘッダー |
Wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |