Fonction StorPortLogTelemetryEx (storport.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | storport.h |