Função StorPortLogTelemetryEx (storport.h)
O StorPortLogTelemetry rotina registra um evento de telemetria de miniporto 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 do barramento de host).
StorAddress
Endereço do dispositivo da unidade de armazenamento. Esse parâmetro é NULL para dispositivos adaptador.
Event
Ponteiro para a estrutura de 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.
Valor de retorno
StorPortLogTelemetryEx retorna um dos seguintes códigos de status:
| Código de retorno | Descrição |
|---|---|
| STOR_STATUS_INVALID_BUFFER_SIZE | Event->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 ->EventBuffernã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. |
Observações
Um miniporto pode chamar StorPortLogTelemetryEx para registrar um evento de telemetria ou medidas de rastreamento com dados personalizados por miniporto. 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 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 |