Macro ScsiPortWmiFireAdapterEvent (scsiwmi.h)

Article
02/07/2025

La routine ScsiPortWmiFireAdapterEvent envoie un événement associé à une unité d’adaptateur au pilote de port pour la remise aux consommateurs de données WMI qui ont demandé la notification de l’événement.

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

Syntaxe

void ScsiPortWmiFireAdapterEvent(
  [in]  HwDeviceExtension,
  [in]  Guid,
  [in]  InstanceIndex,
  [in]  EventDataSize,
  [in]  EventData
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel. Il s’agit d’une zone de stockage par HBA que le pilote de port alloue et initialise pour le compte du pilote miniport. Les pilotes miniport stockent généralement des informations spécifiques à un HBA dans cette extension, telles que l’état de l’adaptateur HBA et les plages d’accès mappées de l’adaptateur HBA. Cette zone est disponible pour le pilote miniport dans le DeviceExtension->HwDeviceExtension membre de l’objet d’appareil du HBA immédiatement après l’appel du pilote miniport ScsiPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil.

[in] Guid

Pointeur vers le GUID qui représente le bloc d’événements.

[in] InstanceIndex

Si le bloc d’événements a plusieurs instances, spécifie l’index de l’instance.

[in] EventDataSize

Spécifie le nombre d’octets de données à EventData, sans inclure les octets de remplissage au début de la mémoire tampon de données d’événement. Si aucune donnée n’est générée pour un événement, EventDataSize doit être défini sur zéro.

[in] EventData

Pointeur vers une mémoire tampon allouée au pilote miniport contenant les données générées par le pilote miniport pour l’événement. La mémoire tampon doit être au moins la taille des données d’événement et 0x40 octets de remplissage au début de la mémoire tampon.

Valeur de retour

Aucun

Remarques

Cette routine est une version simplifiée de la routine ScsiPortWmiFireLogicalUnitEvent. Alors que, ScsiPortWmiFireLogicalUnitEvent peut être utilisé pour notifier le pilote de port des événements associés aux adaptateurs et aux périphériques de stockage, ScsiPortWmiFireAdapterEvent est utilisé pour notifier le pilote de port des événements associés aux adaptateurs uniquement.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	scsiwmi.h (include Miniport.h, Scsi.h)

Voir aussi

ScsiPortWmiFireLogicalUnitEvent

Partager via