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 ocorrer uma verificação de bug.
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 de Extensões de Dispositivo.
[in] BugcheckCode
Especifica um código de verificação de bug .
[in] Buffer
Ponteiro para o local de memória em que o driver de miniporto pode armazenar os dados que serão anexados ao arquivo de despejo.
[in] BufferSize
Especifica o tamanho, em bytes, do buffer apontado pelo parâmetro do buffer.
Valor de retorno
Nenhum
Observações
Essa função está disponível no Windows XP SP1 e posterior.
Essa função é chamada quando ocorre uma verificação de bug. 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 de BufferSize bytes no buffer.
Um driver de miniport 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 miniport de vídeo para o sistema.
Para facilitar a recuperação do sistema após uma verificação de bug, 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 miniporto 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 no IRQL gerado e não deve tentar acessar o código ou os dados pagináveis.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | video.h (inclua Video.h) |