Función StorPortNvmeLogTelemetry (storport.h)
Un controlador de miniport de NMVe llama a la función storPortNvmeLogTelemetry para registrar eventos de telemetría para un dispositivo NVMe.
Sintaxis
ULONG StorPortNvmeLogTelemetry(
PVOID HwDeviceExtension,
PVOID ControllerHandle,
ULONG NamespaceId,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
Parámetros
HwDeviceExtension
[in] Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).
ControllerHandle
[in/optional] Para un miniporte NVMe de tejido, si el evento es específico del controlador, ControllerHandle es el identificador de StorPort para el controlador NVMe. De lo contrario, ControllerHandle debe ser NULL.
NamespaceId
[in] Si el evento es específico del espacio de nombres, NamespaceId es el identificador del espacio de nombres. De lo contrario, namespaceId debe ser 0.
Event
[in] Puntero a una estructura de STORPORT_TELEMTRY_EVENT que contiene campos de eventos estándar y datos de carga de miniporte.
Category
[in] Valor de STOR_TELEMETRY_CATEGORY que especifica la categoría de telemetría que se va a registrar.
Valor devuelto
storPortNvmeLogTelemetry devuelve STOR_STATUS_SUCCESS si el evento de telemetría se registra correctamente. De lo contrario, devuelve un código de error STOR_STATUS como el siguiente:
| Código devuelto | Descripción |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Esta función no se implementa en el sistema operativo activo. |
| STOR_STATUS_INVALID_PARAMETER | Se produce un error en la operación con este valor devuelto si uno o varios de los parámetros no son válidos. |
Observaciones
Un miniport nvMe puede llamar a esta función para registrar un evento de medidas de registro de seguimiento con datos personalizados de miniporte que se encapsulan en Event.
storPortNvmeLogTelemetry permite además al autor de la llamada especificar un tipo de categoría de telemtry.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 11, versión 24H2 |
| encabezado de | storport.h |