Função StorPortNvmeLogTelemetry (storport.h)
Um driver de miniporto NMVe chama a função StorPortNvmeLogTelemetry para registrar eventos de telemetria em um dispositivo NVMe.
Sintaxe
ULONG StorPortNvmeLogTelemetry(
PVOID HwDeviceExtension,
PVOID ControllerHandle,
ULONG NamespaceId,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
Parâmetros
HwDeviceExtension
[in] Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).
ControllerHandle
[in/optional] Para um miniporto NVMe de malha, se o evento for específico do controlador, ControllerHandle será o identificador do StorPort para o controlador NVMe. Caso contrário, ControllerHandle deverá ser NULL.
NamespaceId
[in] Se o evento for específico do namespace, NamespaceId será o identificador do namespace. Caso contrário, NamespaceId deve ser 0.
Event
[in] Ponteiro para uma estrutura de STORPORT_TELEMTRY_EVENT que contém campos de evento padrão e dados de conteúdo de miniporto.
Category
[in] Um valor STOR_TELEMETRY_CATEGORY que especifica a categoria de telemetria a ser registrada em log.
Valor de retorno
StorPortNvmeLogTelemetry retornará STOR_STATUS_SUCCESS se o evento de telemetria for registrado com êxito. Caso contrário, ele retornará um código de erro STOR_STATUS, como o seguinte:
| Código de retorno | Descrição |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Essa função não é implementada no sistema operacional ativo. |
| STOR_STATUS_INVALID_PARAMETER | A operação falhará com esse valor retornado se um ou mais dos parâmetros forem inválidos. |
Observações
Um miniporto NVMe pode chamar essa função para registrar em log um evento de medidas de rastreamento com dados personalizados por miniporto encapsulados em Event.
StorPortNvmeLogTelemetry também permite que o chamador especifique um tipo de categoria de telemtry.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 11, versão 24H2 |
| cabeçalho | storport.h |