Função StorPortLogTelemetry (storport.h)
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 |
|---|---|
|
EventBufferLength é maior que EVENT_BUFFER_MAX_LENGTH. |
|
Um ponteiro para um dos parâmetros é NULL ou a estrutura EventBufferLength/EventBuffer em Event não corresponde. |
|
Essa função não é implementada no sistema operacional ativo. |
|
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 |