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

Requisito	Valor
Cliente mínimo com suporte	Windows 2000
Plataforma de Destino	Área de Trabalho
Cabeçalho	video.h (incluir Video.h)
Biblioteca	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DIRQL

Confira também

VideoDebugPrint