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) |