PFND3DDDI_ESCAPECB função de retorno de chamada (d3dumddi.h)

A função de retorno de chamada pfnEscapeCb compartilha informações com o driver de miniporto de exibição.

Sintaxe

PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;

HRESULT Pfnd3dddiEscapecb(
  HANDLE hAdapter,
  const D3DDDICB_ESCAPE *unnamedParam2
)
{...}

Parâmetros

hAdapter

Um identificador para o objeto do adaptador gráfico.

unnamedParam2

pData [in, out]

Um ponteiro para uma estrutura D3DDDICB_ESCAPE que descreve as informações compartilhadas.

Retornar valor

pfnEscapeCb retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	As informações foram compartilhadas com êxito.
E_OUTOFMEMORY	O pfnEscapeCb não pôde ser concluído devido à memória insuficiente.
E_INVALIDARG	Os parâmetros foram validados e determinados como incorretos.
D3DDDIERR_DEVICEREMOVED	O pfnEscapeCb não pôde iniciar uma chamada para a função DxgkDdiEscape do driver de miniporta de exibição porque ocorreu uma parada de Plug and Play (PnP) ou um evento TDR (Detecção e Recuperação de Tempo limite). A função de driver de exibição do modo de usuário que chamou pfnEscapeCb deve retornar esse código de erro de volta ao runtime do Direct3D. Direct3D Versão 9 Observação: para obter mais informações sobre como retornar códigos de erro, consulte Retornando códigos de erro recebidos de funções de runtime. Versões 10 e 11 do Direct3D Observação: se a função driver não retornar um valor (ou seja, tem VOID para um tipo de parâmetro de retorno), a função de driver chamará a função pfnSetErrorCb para enviar um código de erro de volta ao runtime. Para obter mais informações sobre como lidar com códigos de erro, consulte Tratamento de erros.

 

Essa função também pode retornar outros valores HRESULT.

Comentários

Um driver de exibição no modo de usuário chama pfnEscapeCb para compartilhar informações diversas com o driver de miniporto de exibição de uma maneira que não é compatível com nenhuma outra comunicação de driver. O driver de exibição no modo de usuário pode enviar informações diversas para o driver de miniporto de exibição ou pode recuperar informações do driver de miniporto de exibição.

Observação do Direct3D versão 11: Para obter mais informações sobre como o driver chama pfnEscapeCb, consulte Alterações do Direct3D 10.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape