StorPortNvmeLogTelemetry, fonction (storport.h)
Un pilote miniport NMVe appelle la fonction StorPortNvmeLogTelemetry pour consigner les événements de télémétrie pour un appareil NVMe.
Syntaxe
ULONG StorPortNvmeLogTelemetry(
PVOID HwDeviceExtension,
PVOID ControllerHandle,
ULONG NamespaceId,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
Paramètres
HwDeviceExtension
[in] Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).
ControllerHandle
[in/optional] Pour un miniport NVMe de structure, si l’événement est spécifique au contrôleur, ControllerHandle est le handle de StorPort pour le contrôleur NVMe. Sinon, ControllerHandle doit être NULL.
NamespaceId
[in] Si l’événement est spécifique à l’espace de noms, NamespaceId est l’identificateur d’espace de noms. Sinon, NamespaceId doit être 0.
Event
[in] Pointeur vers une structure STORPORT_TELEMTRY_EVENT qui contient des champs d’événement standard et des données de charge utile miniport.
Category
[in] Valeur STOR_TELEMETRY_CATEGORY qui spécifie la catégorie de télémétrie à journaliser.
Valeur de retour
StorPortNvmeLogTelemetry retourne STOR_STATUS_SUCCESS si l’événement de télémétrie est correctement journalisé. Sinon, elle retourne un code d’erreur STOR_STATUS comme suit :
| Retourner le code | Description |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Cette fonction n’est pas implémentée sur le système d’exploitation actif. |
| STOR_STATUS_INVALID_PARAMETER | L’opération échoue avec cette valeur de retour si un ou plusieurs des paramètres ne sont pas valides. |
Remarques
Un miniport NVMe peut appeler cette fonction pour consigner un événement de mesures de suivi avec des données personnalisées miniport qui sont encapsulées dans 'événement.
StorPortNvmeLogTelemetry permet également à l’appelant de spécifier un type de catégorie de télémétrie.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 11, version 24H2 |
| d’en-tête | storport.h |