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

Confira também

STOR_TELEMETRY_CATEGORY

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetry