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 |