PFND3DDDI_ESCAPECB função de retorno de chamada (d3dumddi.h)
A função pfnEscapeCb de retorno de chamada 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 [dentro, fora]
Um ponteiro para uma estrutura D3DDDICB_ESCAPE que descreve as informações compartilhadas.
Valor de retorno
pfnEscapeCb retorna um dos seguintes valores:
| Código de retorno | descrição |
|---|---|
| S_OK | As informações foram compartilhadas com êxito. |
| E_OUTOFMEMORY | 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 miniport de exibição porque ocorreu uma parada de PnP (Plug and Play) 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 chamada pfnEscapeCb deve retornar esse código de erro para o 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. direct3D versões 10 e 11 Observação: se a função de driver não retornar um valor (ou seja, tem VOID para um tipo de parâmetro de retorno), a função de driver chama a função pfnSetErrorCb para enviar um código de erro de volta para o 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.
Observações
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 seja suportada por 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.
Direct3D Versão 11 Observação: Para obter mais informações sobre como o driver chama pfnEscapeCb, consulte Alterações do Direct3D 10.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |