PVIDEO_BUGCHECK_CALLBACK função de retorno de chamada (video.h)
A função HwVidBugcheckCallback permite que o driver de miniporto acrescente dados a um arquivo de despejo quando ocorre um bug marcar.
Sintaxe
PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;
void PvideoBugcheckCallback(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG BugcheckCode,
[in] IN PUCHAR Buffer,
[in] IN ULONG BufferSize
)
{...}
Parâmetros
[in] HwDeviceExtension
Ponteiro para a área de armazenamento por adaptador do driver de miniport. Para obter mais informações, consulte Extensões de dispositivo.
[in] BugcheckCode
Especifica um código de marcar de bugs.
[in] Buffer
Ponteiro para o local de memória em que o driver de miniporto pode armazenar os dados que devem ser acrescentados ao arquivo de despejo.
[in] BufferSize
Especifica o tamanho, em bytes, do buffer apontado pelo parâmetro Buffer .
Retornar valor
Nenhum
Comentários
Essa função está disponível no Windows XP SP1 e posterior.
Essa função é chamada quando ocorre um bug marcar. O driver de miniporto pode coletar dados que devem ser acrescentados ao arquivo de despejo e gravar esses dados no buffer. O driver não deve gravar mais do que BufferSize bytes no buffer.
Um driver de miniporto de vídeo registra a função HwVidBugcheckCallback chamando a função VideoPortRegisterBugcheckCallback . A função VideoPortRegisterBugcheckCallback expõe esse retorno de chamada fornecido pelo driver de miniporto de vídeo para o sistema.
Para facilitar a recuperação do sistema após um bug marcar, todos os registros acessados por essa função não devem impedir a capacidade do hardware de transferir para o modo de fallback, independentemente do estado do dispositivo. Além disso, a função deve retornar o controle ao chamador.
Como um sistema pode consistir em vários drivers de miniporta de vídeo, os fornecedores devem adicionar uma cadeia de caracteres de identificação aos dados que essa função acrescenta ao arquivo de despejo.
A função é chamada em IRQL gerado e não deve tentar acessar código ou dados pagináveis.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | video.h (incluir Video.h) |