SCSIWMIGUIDREGINFO 構造体 (scsiwmi.h)

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

SCSIWMIGUIDREGINFO 構造体には、SCSI ミニポートドライバーでサポートされている特定のデータまたはイベントブロックに関する情報が含まれています。

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

構文

typedef struct {
  LPCGUID Guid;
  ULONG   InstanceCount;
  ULONG   Flags;
} SCSIWMIGUIDREGINFO, *PSCSIWMIGUIDREGINFO;

メンバー

Guid

ブロックを識別する GUID を指します。

InstanceCount

ブロックに対して定義されているインスタンスの数を指定します。

Flags

ブロックの特性を示します。 SCSI ポートドライバーは、ミニポートドライバーの代わりに、次のWMIREG_FLAG_XXX 以外のすべてを設定します。ミニポートドライバーは、次のフラグの 1 つ以上を設定する可能性があります。

WMIREG_FLAG_EVENT_ONLY_GUID

ブロックはイベントとしてのみ有効または無効にでき、クエリや設定はできません。このフラグがクリアされている場合は、ブロックに対してクエリを実行したり設定したりすることもできます。

WMIREG_FLAG_EXPENSIVE

ポートドライバーは、データコンシューマーがデータブロックを初めて開いたときに enable-collection SRB を送信し、最後のデータコンシューマーがデータブロックを閉じるときに、disable-collection SRB を要求します。このようなデータの収集がパフォーマンスに影響する場合は、これをお勧めします。ミニポートドライバーは、データコンシューマーがブロックを開いて明示的に要求するまで、データを収集する必要はありません。

WMIREG_FLAG_REMOVE_GUID

設定時に、以前に登録されたブロックのサポートを削除します。

注釈

ミニポートドライバーは、ScsiPortWmiDispatchFunction の WmiLibInfo パラメーターに SCSIWMIREGGUID 配列を含むSCSI_WMILIB_CONTEXTへのポインターを渡します。ミニポートドライバーは、 ScsiPortWmiDispatchFunction を呼び出すたびにこの情報を渡します。配列内の各 SCSIWMIREGGUID 構造体は、ミニポートドライバーのデータまたはイベントブロックのいずれかを表します。

ミニポートドライバーの SCSIWMIREGGUID 配列には、デバイスの種類に 対して wmicore.mof で定義されているすべての標準データブロックを含める必要があり、ミニポートドライバーで定義されたデータとイベントブロックを含めることができます。ミニポートドライバーは、ミニポートドライバーのバイナリイメージにアタッチされ、ミニポートドライバーの HwScsiWmiQueryReginfo ルーチンの MofResourceName パラメーターで指定されたリソースとしてコンパイルされる MOF ファイル内のカスタムデータとイベントブロックを定義します。

ブロックの定義の詳細については、「 Windows Management Instrumentation」を参照してください。