Fonction StorPortLogTelemetry (storport.h)
La routine StorPortLogTelemetry consigne un événement de télémétrie miniport pour faciliter le diagnostic ou la collecte d’informations utiles. 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 définis dans la structure STORPORT_TELEMETRY_EVENT.
Syntaxe
ULONG StorPortLogTelemetry(
[in] PVOID HwDeviceExtension,
[in, optional] PSTOR_ADDRESS StorAddress,
[in] PSTORPORT_TELEMETRY_EVENT Event
);
Paramètres
[in] HwDeviceExtension
Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).
[in, optional] StorAddress
Adresse du périphérique d’unité de stockage. Ce paramètre a la valeur NULL pour les périphériques adaptateurs.
[in] Event
Pointeur vers la structure STORPORT_TELEMETRY_EVENT qui contient la charge utile des données de télémétrie.
Valeur retournée
StorPortLogTelemetry retourne l’un des codes status suivants :
| Code de retour | Description |
|---|---|
|
EventBufferLength est plus grand que EVENT_BUFFER_MAX_LENGTH. |
|
Un pointeur vers l’un des paramètres est NULL ou EventBufferLength/EventBuffer dans La structure d’événements ne correspond pas. |
|
Cette fonction n’est pas implémentée sur le système d’exploitation actif. |
|
Les données d’événement de télémétrie ont été correctement journalisées. |
Remarques
Si un paramètre de la structure d’événements n’est pas nommé, Event-ParameterNameX> == NULL, la routine définit la valeur du paramètre correspondant sur 0.
Si le miniport n’a aucune charge utile à remplir dans Event-EventBuffer>, il doit définir Event-EventBufferLength> = 0, ainsi que Event-EventBuffer> = NULL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 version 1703 |
| Serveur minimal pris en charge | Windows Server 2016 |
| Plateforme cible | Windows |
| En-tête | storport.h (inclure Storport.h) |
| IRQL | Quelconque |