Structure SCSIWMIGUIDREGINFO (scsiwmi.h)

Article
02/26/2024

La structure SCSIWMIGUIDREGINFO contient des informations sur un bloc de données ou d’événements donné pris en charge par un pilote miniport SCSI.

Note Les modèles de pilote de port SCSI et de pilote miniport SCSI peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser les modèles de pilote Storport et de pilote miniport Storport .

Syntaxe

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

Membres

Guid

Pointe vers le GUID qui identifie le bloc.

InstanceCount

Spécifie le nombre d’instances définies pour le bloc.

Flags

Indique les caractéristiques du bloc. Le pilote de port SCSI définit toutes les WMIREG_FLAG_XXX suivantes pour le compte du pilote miniport. Un pilote miniport peut définir un ou plusieurs des indicateurs suivants :

WMIREG_FLAG_EVENT_ONLY_GUID

Le bloc peut être activé ou désactivé en tant qu’événement uniquement, et ne peut pas être interrogé ou défini. Si cet indicateur est clair, le bloc peut également être interrogé ou défini.

WMIREG_FLAG_EXPENSIVE

Demande au pilote de port d’envoyer un SRB d’activation-collecte la première fois qu’un consommateur de données ouvre le bloc de données et un SRB de désactivation-collecte lorsque le dernier consommateur de données ferme le bloc de données. Cela est recommandé si la collecte de ces données affecte les performances. Un pilote miniport n’a pas besoin de collecter les données tant qu’un consommateur de données ne les demande pas explicitement en ouvrant le bloc.

WMIREG_FLAG_REMOVE_GUID

Supprime la prise en charge d’un bloc précédemment inscrit lorsqu’il est défini.

Remarques

Le pilote miniport transmet un pointeur vers un SCSI_WMILIB_CONTEXT qui contient un tableau SCSIWMIREGGUID dans le paramètre WmiLibInfo de ScsiPortWmiDispatchFunction. Le pilote miniport transmet ces informations chaque fois qu’il appelle ScsiPortWmiDispatchFunction. Chaque structure SCSIWMIREGGUID dans le tableau représente l’un des blocs de données ou d’événements du pilote miniport.

Le tableau SCSIWMIREGGUID d’un pilote miniport doit inclure tous les blocs de données standard définis dans wmicore.mof pour son type de périphérique, et peut inclure des blocs d’événements et de données définis par le pilote miniport. Un pilote miniport définit des blocs de données et d’événements personnalisés dans un fichier MOF, qui est compilé en tant que ressource attachée à l’image binaire du pilote miniport et spécifiée dans le paramètre MofResourceName de la routine HwScsiWmiQueryReginfo du pilote miniport.

Pour plus d’informations sur la définition de blocs, consultez Windows Management Instrumentation.

Configuration requise

Condition requise	Valeur
En-tête	scsiwmi.h (inclure Scsiwmi.h)

Voir aussi

HwScsiWmiQueryReginfo

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction

Partager via