Função StorPortLogTelemetry (storport.h)

  • Artigo

A rotina StorPortLogTelemetry registra um evento de telemetria de miniporte para ajudar a diagnosticar ou coletar informações úteis. O miniporto pode registrar oito pares nome-valor de uso geral e um buffer com comprimento máximo de 4KB, bem como vários campos relacionados a eventos definidos na estrutura STORPORT_TELEMETRY_EVENT.

Sintaxe

ULONG StorPortLogTelemetry(
  [in]           PVOID                     HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS             StorAddress,
  [in]           PSTORPORT_TELEMETRY_EVENT Event
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[in, optional] StorAddress

O endereço do dispositivo da unidade de armazenamento. Esse parâmetro é NULL para dispositivos adaptador.

[in] Event

Ponteiro para a estrutura STORPORT_TELEMETRY_EVENT que contém a carga de dados de telemetria.

Retornar valor

StorPortLogTelemetry retorna um dos seguintes códigos de status:

Código de retorno Descrição
STOR_STATUS_INVALID_BUFFER_SIZE
 EventBufferLength é maior que EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER
 Um ponteiro para um dos parâmetros é NULL ou a estrutura EventBufferLength/EventBuffer em Event não corresponde.
STOR_STATUS_NOT_IMPLEMENTED
 Essa função não é implementada no sistema operacional ativo.
STATUS_SUCCESS
 Os dados do evento de telemetria foram registrados com êxito.

Comentários

Se qualquer parâmetro na estrutura Event não for nomeado, Event-ParameterNameX> == NULL, a rotina definirá o valor do parâmetro correspondente como 0.

Se o miniporto não tiver nenhum conteúdo para preencher Event-EventBuffer>, ele deverá definir Event-EventBufferLength> = 0, bem como Event-EventBuffer> = NULL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho storport.h (inclua Storport.h)
IRQL Qualquer

Confira também

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx