Funzione StorPortLogTelemetry (storport.h)

  • Articolo

La routine StorPortLogTelemetry registra un evento di telemetria di miniport per facilitare la diagnosi o la raccolta di informazioni utili. Il miniport può registrare otto coppie nome-valore per utilizzo generico e un buffer con lunghezza massima di 4 KB, nonché diversi campi correlati a eventi definiti nella struttura STORPORT_TELEMETRY_EVENT.

Sintassi

ULONG StorPortLogTelemetry(
  [in]           PVOID                     HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS             StorAddress,
  [in]           PSTORPORT_TELEMETRY_EVENT Event
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).

[in, optional] StorAddress

Indirizzo del dispositivo dell'unità di archiviazione. Questo parametro è NULL per i dispositivi adattatori.

[in] Event

Puntatore alla struttura STORPORT_TELEMETRY_EVENT che contiene il payload dei dati di telemetria.

Valore restituito

StorPortLogTelemetry restituisce uno dei codici di stato seguenti:

Codice restituito Descrizione
STOR_STATUS_INVALID_BUFFER_SIZE
 EventBufferLength è maggiore di EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER
 Un puntatore a uno dei parametri è NULL o EventBufferLength/EventBuffer nella struttura event non corrispondente.
STOR_STATUS_NOT_IMPLEMENTED
 Questa funzione non viene implementata nel sistema operativo attivo.
STATUS_SUCCESS
 I dati dell'evento di telemetria sono stati registrati correttamente.

Commenti

Se un parametro nella struttura Event non è denominato, Event-ParameterNameX> == NULL, la routine imposterà il valore del parametro corrispondente su 0.

Se miniport non ha payload da compilare Event-EventBuffer>, deve impostare Event-EventBufferLength> = 0, nonché Event-EventBuffer> = NULL.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1703
Server minimo supportato Windows Server 2016
Piattaforma di destinazione Windows
Intestazione storport.h (include Storport.h)
IRQL Qualsiasi

Vedi anche

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx