SCSI_WMI_REQUEST_BLOCK 構造体 (storport.h)

[アーティクル]
08/07/2023

この構造は、WMI コマンドで使用する特別なバージョンの SCSI_REQUEST_BLOCK です。

メモ SCSI ポートドライバーと SCSI ミニポートドライバーモデルは、今後変更または使用できない可能性があります。代わりに、 Storport ドライバーモデルと Storport ミニポートドライバーモデルを使用することをお勧めします。

構文

typedef struct _SCSI_WMI_REQUEST_BLOCK {
  USHORT Length;
  UCHAR  Function;
  UCHAR  SrbStatus;
  UCHAR  WMISubFunction;
  UCHAR  PathId;
  UCHAR  TargetId;
  UCHAR  Lun;
  UCHAR  Reserved1;
  UCHAR  WMIFlags;
  UCHAR  Reserved2[2];
  ULONG  SrbFlags;
  ULONG  DataTransferLength;
  ULONG  TimeOutValue;
  PVOID  DataBuffer;
  PVOID  DataPath;
  PVOID  Reserved3;
  PVOID  OriginalRequest;
  PVOID  SrbExtension;
  ULONG  Reserved4;
  ULONG  Reserved6;
  UCHAR  Reserved5[16];
} SCSI_WMI_REQUEST_BLOCK, *PSCSI_WMI_REQUEST_BLOCK;

メンバー

Length

この構造体のサイズをバイト単位で指定します。

Function

SRB_FUNCTION_WMI。要求が WMI 要求であることを指定します。このメンバーが SRB_FUNCTION_WMI に設定されていない場合、ミニポートドライバーは要求を失敗させる必要があります。

SrbStatus

完了した要求の状態を返します。このメンバーは、要求が完了したことを OS 固有のドライバーに通知する前に、ミニポートドライバーによって設定する必要があります ScsiPortNotification と RequestComplete します。このメンバーの値には、SCSI_REQUEST_BLOCKの SrbStatus にリストされている任意の値を指定できます。

WMISubFunction

実行する WMI アクションを示します。ミニポートドライバーは、この値に MinorFunction を設定して ScsiPortWmiDispatchFunction を呼び出します。サブ関数の値は、WMI 操作を識別する WMI マイナー IRP 番号に対応します。

PathId

要求の SCSI ポートまたはバスを示します。この値は 0 から始まります。 SRB_WMI_FLAGS_ADAPTER_REQUESTが WMIFlags で設定されている場合、このメンバーは予約されています。

TargetId

バス上のターゲットコントローラーまたはデバイスを示します。 SRB_WMI_FLAGS_ADAPTER_REQUESTが WMIFlags で設定されている場合、このメンバーは予約されています。

Lun

デバイスの論理ユニット番号を示します。 SRB_WMI_FLAGS_ADAPTER_REQUESTが WMIFlags で設定されている場合、このメンバーは予約されています。

Reserved1

システム使用用に予約されており、ミニポートドライバーでは使用できません。

WMIFlags

SRB_WMI_FLAGS_ADAPTER_REQUESTが設定されていて、 PathId、 TargetId、 Lun が予約されている場合、WMI 要求がアダプター用であることを示します。それ以外の場合、 WMIFlags は NULL になり、 PathId、 TargetId、Lun で指定されたデバイスに対する要求であることを示 します。

Reserved2[2]

システム使用用に予約されており、ミニポートドライバーでは使用できません。

SrbFlags

要求に関するさまざまなパラメーターとオプションを示します。 SrbFlags は読み取り専用です。このメンバーは、次のフラグの 1 つ以上の ORed に一緒に設定されます。

SRB_FLAGS_DATA_IN

デバイスからシステムにデータが転送されることを示します。

SRB_FLAGS_DATA_OUT

システムからデバイスにデータが転送されることを示します。

SRB_FLAGS_NO_DATA_TRANSFER

この要求でデータ転送がないことを示します。この設定を行うと、フラグSRB_FLAGS_DATA_OUT、SRB_FLAGS_DATA_IN、SRB_FLAGS_UNSPECIFIED_DIRECTIONが明確になります。

SRB_FLAGS_DISABLE_SYNCH_TRANSFER

可能であれば、この転送要求に対して非同期 I/O を実行する HBA を示します。同期 I/O が以前にネゴシエートされた場合、転送を実行する前に、HBA は非同期 I/O に対して再ネゴシエーションする必要があります。

SRB_FLAGS_DISABLE_DISCONNECT

HBA は、この要求の処理中にターゲットが SCSI バスから切断できないようにする必要があることを示します。

DataTransferLength

データバッファーのサイズをバイト単位で示します。ミニポートドライバーは、BufferSize がこの値に設定された ScsiPortWmiDispatchFunction を呼び出します。アンダーランが発生した場合、ミニポートドライバーは、実際に転送されたバイト数にこのメンバーを更新する必要があります。

TimeOutValue

OS 固有のポートドライバーがタイムアウトと見なす前に要求を実行できる間隔を秒単位で示します。ミニポートドライバーは、ポートドライバーが既に行うため、要求を時刻に必要ありません。

DataBuffer

データバッファーをポイントします。ミニポートドライバーは、バッファーをこの値に設定して ScsiPortWmiDispatchFunction を呼び出します。ミニポートドライバーは、HBA のPORT_CONFIGURATION_INFORMATIONの MapBuffers の値に関係なく、データポインターとしてこの値を使用できます。ミニポートドライバーは、DMA を使用してバッファーに直接データを転送することはできません。

DataPath

この要求の WMI データパスを指定します。ミニポートドライバーは、DataPath がこの値に設定された ScsiPortWmiDispatchFunction を呼び出します。

Reserved3

システム使用用に予約されており、ミニポートドライバーでは使用できません。

OriginalRequest

この要求の IRP を指します。このメンバーは、ミニポートドライバーには関係ありません。

SrbExtension

Srb 拡張機能をポイントします。 HW_INITIALIZATION_DATAで SrbExtensionSize を 0 に設定した場合、ミニポートドライバーはこのメンバーを使用しないでください。 SrbExtension のメモリは OS 固有のポートドライバーによって初期化されず、ミニポートドライバーによって決定されたデータに HBA から直接アクセスできます。対応する物理アドレスは、SrbExtension ポインターを使用して ScsiPortGetPhysicalAddress を呼び出すことによって取得できます。

Reserved4

システム使用用に予約されており、ミニポートドライバーでは使用できません。

Reserved6

システム使用用に予約されており、ミニポートドライバーでは使用できません。このメンバーは、Windows Server 2003 SP1 以降で有効です。

Reserved5[16]

システム使用用に予約されており、ミニポートドライバーでは使用できません。

注釈

Windows NTストレージクラスとフィルタードライバーは、WMI SRB をシステムポートドライバーに送信できます。システムポートドライバーは、ミニポートドライバーの代わりに特定の WMI 要求を処理します。ポートドライバーが WMI 要求を処理できない場合は、ミニポートドライバーに要求を転送します。

ミニポートドライバーは、ミニポートドライバーがPORT_CONFIGURATION_INFORMATION構造で WmiDataProvider を設定する場合にのみ、ポートドライバーから WMI 要求を受信します。ミニポートドライバーが要求をサポートしている場合は、それを処理し、最初に RequestComplete を使用して、次に NextRequest (または NextLuRequest) を使用して ScsiPortNotification を 2 回呼び出して要求を完了する必要があります。

ミニポートドライバーでの WMI のサポートについては、「 Windows Management Instrumentation」を参照してください。