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)

Confira também

VideoPortRegisterBugcheckCallback