Função StorPortLogTelemetry (storport.h)
O StorPortLogTelemetry rotina registra um evento de telemetria de miniporto para ajudar a diagnosticar ou coletar informações úteis. O miniporto pode registrar oito pares nome-valor de finalidade 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 de STORPORT_TELEMETRY_EVENT que contém a carga de dados de telemetria.
Valor de retorno
StorPortLogTelemetry retorna um dos seguintes códigos de status:
| Código de retorno | Descrição |
|---|---|
|
EventBufferLength é maior que EVENT_BUFFER_MAX_LENGTH. |
|
Um ponteiro para um dos parâmetros é NULL ou EventBufferLength/EventBuffer na estrutura event não corresponde. |
|
Essa função não é implementada no sistema operacional ativo. |
|
Os dados do evento de telemetria foram registrados com êxito. |
Observações
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 |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1703 |
| servidor com suporte mínimo | Windows Server 2016 |
| da Plataforma de Destino | Windows |
| cabeçalho | storport.h (inclua Storport.h) |
| IRQL | Qualquer |