Macro ScsiPortWmiFireAdapterEvent (scsiwmi.h)

Article
02/29/2024

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é une notification de l’événement.

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

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 adaptateur 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 à L’adaptateur 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 membre DeviceExtension-HwDeviceExtension> de l’objet d’appareil de l’adaptateur HBA immédiatement après que le pilote miniport a appelé 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 du instance.

[in] EventDataSize

Spécifie le nombre d’octets de données dans EventData, sans inclure les octets de pavé au début de la mémoire tampon des 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 avoir au moins la taille des données d’événement plus 0x40 octets de pavé au début de la mémoire tampon.

Valeur de retour

None

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 informer le pilote de port des événements associés uniquement aux cartes.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	scsiwmi.h (inclure Miniport.h, Scsi.h)

Voir aussi

ScsiPortWmiFireLogicalUnitEvent

Partager via