Função VideoPortLogError (video.h)

A função VideoPortLogError registra erros no log de eventos do sistema quando um driver de miniporta detecta uma condição de erro de hardware durante operações de E/S.

Sintaxe

VIDEOPORT_API VOID VideoPortLogError(
  PVOID                 HwDeviceExtension,
  PVIDEO_REQUEST_PACKET Vrp,
  VP_STATUS             ErrorCode,
  ULONG                 UniqueId
);

Parâmetros

HwDeviceExtension

Ponteiro para a extensão de dispositivo do driver de miniport.

Vrp

[opcional] Ponteiro para uma estrutura [VIDEO_REQUEST_PACKET] que descreve o VRP (pacote de solicitação de vídeo) se um estiver associado ao erro; caso contrário, NULL.

ErrorCode

Especifica um código de erro definido pelo driver de miniporto que indica o tipo de erro de hardware.

UniqueId

Especifica um identificador exclusivo para o erro. Esse valor diferencia o erro atual de outros erros com o mesmo ErrorCode. Para alguns drivers de miniporta, isso identifica a linha de código em que o erro foi detectado; para outras pessoas, é um valor retornado pelo hardware.

Retornar valor

Nenhum

Comentários

Os drivers de miniport devem chamar VideoPortLogError para notificar o usuário se o driver encontrar erros de hardware incomuns durante operações normais. Postar esses erros no log de eventos do sistema avisa ao usuário que o adaptador de vídeo pode estar falhando para que o usuário possa substituir (ou reconfigurar) o adaptador antes que ocorra uma falha total de hardware.

No entanto, os drivers de miniporto não devem registrar erros, como "falha ao detectar hardware", que ocorrem com frequência durante a operação normal.

VideoPortLogError pode ser chamado da função HwVidInterrupt ou HwVidSynchronizeExecutionCallback de um driver de miniport.

Requisitos

Confira também

VideoDebugPrint