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 |