Structure SCSIWMIGUIDREGINFO (scsiwmi.h)
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.
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) |