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 を含む)

関連項目

ZwSetInformationFile