Fonction StorPortLogTelemetryEx (storport.h)

Article
02/26/2024

La routine StorPortLogTelemetry enregistre un événement de télémétrie miniport pour faciliter le diagnostic ou la collecte d’informations utiles.

Syntaxe

ULONG StorPortLogTelemetryEx(
  PVOID                     HwDeviceExtension,
  PSTOR_ADDRESS             StorAddress,
  PSTORPORT_TELEMETRY_EVENT Event,
  STOR_TELEMETRY_CATEGORY   Category
);

Paramètres

HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

StorAddress

Adresse du périphérique d’unité de stockage. Ce paramètre est NULL pour les périphériques adaptateurs.

Event

Pointeur vers la structure STORPORT_TELEMETRY_EVENT qui contient la charge utile des données de télémétrie.

Category

STOR_TELEMETRY_CATEGORY valeur d’énumération qui spécifie la catégorie de données de télémétrie à enregistrer.

Valeur retournée

StorPortLogTelemetryEx retourne l’un des codes status suivants :

Code de retour	Description
STOR_STATUS_INVALID_BUFFER_SIZE	Événement->EventBufferLength est supérieur à EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER	Un pointeur vers l’un des paramètres est NULL ou EventBufferLength est défini sur zéro pour un Event-EventBuffer> non NULL.
STOR_STATUS_NOT_IMPLEMENTED	Cette fonction n’est pas implémentée sur le système d’exploitation actif.
STOR_STATUS_SUCCESS	L’événement de télémétrie a été correctement journalisé.

Remarques

Un miniport peut appeler StorPortLogTelemetryEx pour enregistrer des mesures de suivi ou un événement de télémétrie avec des données personnalisées de miniport. Les miniports spécifient le type de catégorie d’événement dans Catégorie.

Les données d’événement sont encapsulées dans la structure STORPORT_TELEMETRY_EVENT vers laquelle l’événement pointe. Le miniport peut journaliser huit paires nom-valeur à usage général et une mémoire tampon d’une longueur maximale de 4 Ko, ainsi que plusieurs champs liés aux événements.