Função Direct3DCreate9 (d3d9.h)

Crie um objeto IDirect3D9 e retorne uma interface para ele.

Sintaxe

IDirect3D9 * Direct3DCreate9(
  UINT SDKVersion
);

Parâmetros

SDKVersion

Tipo: UINT

O valor desse parâmetro deve ser D3D_SDK_VERSION. Consulte Observações.

Valor retornado

Tipo: IDirect3D9*

Se tiver êxito, essa função retornará um ponteiro para uma interface IDirect3D9 ; caso contrário, um ponteiro NULL será retornado.

Comentários

O objeto Direct3D é o primeiro objeto COM Direct3D que seu aplicativo gráfico precisa criar e o último objeto que seu aplicativo precisa liberar. As funções para enumerar e recuperar recursos de um dispositivo são acessíveis por meio do objeto Direct3D. Isso permite que os aplicativos selecionem dispositivos sem criá-los.

Crie um objeto IDirect3D9, conforme mostrado aqui:

LPDIRECT3D9 g_pD3D = NULL;
    
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
    return E_FAIL;

A interface IDirect3D9 dá suporte à enumeração de adaptadores de exibição ativos e permite a criação de objetos IDirect3DDevice9 . Se o usuário adicionar dinamicamente adaptadores (adicionando dispositivos à área de trabalho ou encaixando um laptop), esses dispositivos não serão incluídos na enumeração. A criação de uma nova interface IDirect3D9 exporá os novos dispositivos.

D3D_SDK_VERSION é passado para essa função para garantir que os arquivos de cabeçalho nos quais um aplicativo é compilado correspondam à versão das DLL do runtime instaladas no computador. D3D_SDK_VERSION só é alterado no runtime quando uma alteração de cabeçalho (ou outra alteração de código) exigiria que um aplicativo fosse recriado. Se essa função falhar, ela indicará que a versão do arquivo de cabeçalho não corresponde à versão da DLL do runtime.

Para obter um exemplo, consulte Criando um dispositivo (Direct3D 9).

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	d3d9.h (inclua D3D9.h)
Biblioteca	D3d9.lib
DLL	D3d9.dll

Confira também

Funções Direct3D