Compartilhar via


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)

Confira também

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice