SCSI_WMILIB_CONTEXT 構造体 (scsiwmi.h)

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

SCSI_WMILIB_CONTEXT構造体は、ミニポートドライバーのデータとイベントブロックの登録情報を提供し、ミニポートドライバーの HwScsiWmiXxx コールバックルーチンのエントリポイントを定義します。

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

構文

typedef struct _SCSIWMILIB_CONTEXT {
  ULONG                     GuidCount;
  PSCSIWMIGUIDREGINFO       GuidList;
  PSCSIWMI_QUERY_REGINFO    QueryWmiRegInfo;
  PSCSIWMI_QUERY_DATABLOCK  QueryWmiDataBlock;
  PSCSIWMI_SET_DATABLOCK    SetWmiDataBlock;
  PSCSIWMI_SET_DATAITEM     SetWmiDataItem;
  PSCSIWMI_EXECUTE_METHOD   ExecuteWmiMethod;
  PSCSIWMI_FUNCTION_CONTROL WmiFunctionControl;
} SCSI_WMILIB_CONTEXT, *PSCSI_WMILIB_CONTEXT;

メンバー

GuidCount

GuidList の SCSIWMIGUIDREGINFO 配列内の構造体の数を指定します。

GuidList

各ブロックの登録情報を含む GuidCount SCSIWMIGUIDREGINFO 構造体の配列を指します。

QueryWmiRegInfo

ドライバーの HwScsiWmiQueryReginfo ルーチンを指します。これは、WMI をサポートするミニポートドライバーに必要なエントリポイントです。

QueryWmiDataBlock

ドライバーの HwScsiWmiQueryDataBlock ルーチンを指します。これは、WMI をサポートするミニポートドライバーに必要なエントリポイントです。

SetWmiDataBlock

ドライバーの HwScsiWmiSetDataBlock ルーチンを指します。これは、WMI をサポートするミニポートドライバーの省略可能なエントリポイントです。ミニポートドライバーがこのルーチンを実装していない場合は、このメンバーを NULL に設定する必要があります

SetWmiDataItem

ドライバーの HwScsiWmiSetDataItem ルーチンを指します。これは、WMI をサポートするミニポートドライバーの省略可能なエントリポイントです。ミニポートドライバーがこのルーチンを実装していない場合は、このメンバーを NULL に設定する必要があります。

ExecuteWmiMethod

ドライバーの HwScsiWmiExecuteMethod ルーチンを指します。これは、WMI をサポートするミニポートドライバーの省略可能なエントリポイントです。ミニポートドライバーがこのルーチンを実装していない場合は、このメンバーを NULL に設定する必要があります

WmiFunctionControl

ドライバーの HwScsiWmiFunctionControl ルーチンを指します。これは、WMI をサポートするミニポートドライバーの省略可能なエントリポイントです。ミニポートドライバーがこのルーチンを実装していない場合は、このメンバーを NULL に設定する必要があります。

注釈

WMI をサポートする SCSI ミニポートドライバーは、初期化されたSCSI_WMILIB_CONTEXT構造体 (またはこのような構造体へのポインター) をデバイス拡張機能に格納します。ミニポートドライバーは、各デバイスオブジェクトが同じデータブロックのセットを提供する場合、複数のデバイスオブジェクトに同じSCSI_WMILIB_CONTEXT構造を使用できます。

ミニポートドライバーは、関数メンバーがSRB_FUNCTION_WMIに設定されている SRB を受信すると、初期化されたSCSI_WMILIB_CONTEXT構造体へのポインターを含む要求パラメーターを使用して ScsiPortWmiDispatchFunction を呼び出します。 ScsiPortWmiDispatchFunction は、ミニポートドライバーの適切な HwScsiWmiXxx ルーチンを呼び出すことによって要求を処理します。

ミニポートドライバーがオプションの HwScsiWmiXxx ルーチンを実装していない場合、ポートドライバーは呼び出し元に適切な状態を返します。