PFND3DDDI_CREATECONTEXTCB função de retorno de chamada (d3dumddi.h)
A função de retorno de chamada pfnCreateContextCb do runtime do Direct3D cria um contexto.
Sintaxe
PFND3DDDI_CREATECONTEXTCB Pfnd3dddiCreatecontextcb;
HRESULT Pfnd3dddiCreatecontextcb(
HANDLE hDevice,
D3DDDICB_CREATECONTEXT *unnamedParam2
)
{...}
Parâmetros
hDevice
[in] Manipule para o dispositivo para o qual o contexto deve ser criado.
unnamedParam2
[entrada/saída] Ponteiro para uma estrutura D3DDDICB_CREATECONTEXT que o driver preenche com as informações necessárias para criar o contexto. Essa estrutura inclui detalhes como ordinal de nó, afinidade de mecanismo e sinalizadores que especificam o comportamento e os recursos do contexto a ser criado. Após a conclusão bem-sucedida, o runtime atualiza essa estrutura com informações sobre o contexto recém-criado.
Valor de retorno
pfnCreateContextCb retorna um HRESULT para indicar o êxito ou falha da solicitação de criação de contexto. Os valores de retorno comuns incluem:
| Código de retorno | Significado |
|---|---|
| S_OK | O contexto foi criado com êxito. |
| E_OUTOFMEMORY | Não há memória suficiente para criar o contexto. |
| E_INVALIDARG | Um ou mais dos argumentos fornecidos são inválidos. |
Observações
O UMD (driver de exibição) no modo de usuário deve chamar explicitamente pfnCreateContextCb de sua implementação CreateDevice para criar um contexto de GPU associado ao dispositivo. Os contextos de GPU são threads de GPU de execução em um dispositivo recém-criado.
O contexto encapsula o estado e os buffers de comando que a GPU usa para executar operações de renderização. A UMD é responsável por gerenciar o ciclo de vida dos contextos que cria, incluindo sua eventual destruição para liberar recursos.
Para obter mais informações sobre a criação de um dispositivo de renderização, consulte fluxo de operação WDDM (Modelo de Driver de Exibição do Windows).
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista (WDDM 1.0) |
| cabeçalho | d3dumddi.h |