Função StorPortLogTelemetryEx (storport.h)
A rotina StorPortLogTelemetry registra um evento de telemetria de miniporte para ajudar a diagnosticar ou coletar informações úteis.
Sintaxe
ULONG StorPortLogTelemetryEx(
PVOID HwDeviceExtension,
PSTOR_ADDRESS StorAddress,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
Parâmetros
HwDeviceExtension
Ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).
StorAddress
Endereço do dispositivo da unidade de armazenamento. Esse parâmetro é NULL para dispositivos adaptador.
Event
Ponteiro para a estrutura STORPORT_TELEMETRY_EVENT que contém a carga de dados de telemetria.
Category
STOR_TELEMETRY_CATEGORY valor de enumeração que especifica a categoria de telemetria a ser registrada.
Retornar valor
StorPortLogTelemetryEx retorna um dos seguintes códigos de status:
| Código de retorno | Descrição |
|---|---|
| STOR_STATUS_INVALID_BUFFER_SIZE | Evento->EventBufferLength é maior que EVENT_BUFFER_MAX_LENGTH. |
| STOR_STATUS_INVALID_PARAMETER | Um ponteiro para um dos parâmetros é NULL ou EventBufferLength é definido como zero para um Event-EventBuffer> não NULL. |
| STOR_STATUS_NOT_IMPLEMENTED | Essa função não é implementada no sistema operacional ativo. |
| STOR_STATUS_SUCCESS | O evento de telemetria foi registrado com êxito. |
Comentários
Um miniporto pode chamar StorPortLogTelemetryEx para registrar um evento de telemetria ou medidas de log de rastreamento com dados personalizados por miniport. Miniportos especificam o tipo de categoria de evento em Categoria.
Os dados do evento são encapsulados na estrutura STORPORT_TELEMETRY_EVENT à qual pontos de evento . O miniporto pode registrar oito pares nome-valor de uso geral e um buffer com um comprimento máximo de 4KB, bem como vários campos relacionados a eventos.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | storport.h |