PFND3DDDI_CREATEDEVICE função de retorno de chamada (d3dumddi.h)
A função CreateDevice cria um contexto gráfico que é referenciado em chamadas subsequentes.
Sintaxe
PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;
HRESULT Pfnd3dddiCreatedevice(
HANDLE hAdapter,
D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}
Parâmetros
hAdapter
Um identificador que identifica o adaptador gráfico.
unnamedParam2
pCreateData [in, out]
Um ponteiro para uma estrutura D3DDDIARG_CREATEDEVICE . Na entrada, essa estrutura contém informações que o driver pode usar. Na saída, o driver especifica informações na estrutura que o runtime do Microsoft Direct3D pode usar.
Retornar valor
CreateDevice retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | O contexto gráfico é criado com êxito. |
| E_OUTOFMEMORY | CreateDevice não pôde alocar a memória necessária para que ela fosse concluída. |
Comentários
Um dispositivo de exibição é um contexto gráfico usado para conter uma coleção de estado de renderização. Vários dispositivos podem ser criados pelo mesmo processo em um determinado adaptador. Observe que o número de dispositivos de exibição que podem existir simultaneamente é limitado apenas pela memória do sistema disponível. Ou seja, um driver não pode codificar um limite máximo de dispositivo.
Em geral, os dispositivos são independentes uns dos outros, para que os recursos criados em um dispositivo não possam ser referenciados ou acessados por recursos criados em outro. No entanto, os recursos entre processos são uma exceção a essa regra.
Quando o runtime do Direct3D chama CreateDevice para criar um dispositivo, o runtime não cria um thread de contexto de GPU (unidade de processamento gráfico) padrão de execução para o dispositivo. O driver deve chamar explicitamente a função pfnCreateContextCb para criar um ou mais contextos conforme necessário.
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) |