Función Direct3DCreate9 (d3d9.h)
Cree un objeto IDirect3D9 y devuelva una interfaz a él.
Sintaxis
IDirect3D9 * Direct3DCreate9(
UINT SDKVersion
);
Parámetros
SDKVersion
Tipo: UINT
El valor de este parámetro debe ser D3D_SDK_VERSION. Vea la sección Comentarios.
Valor devuelto
Tipo: IDirect3D9*
Si se ejecuta correctamente, esta función devuelve un puntero a una interfaz IDirect3D9 ; de lo contrario, se devuelve un puntero NULL .
Comentarios
El objeto Direct3D es el primer objeto COM de Direct3D que la aplicación gráfica necesita para crear y el último objeto que la aplicación necesita liberar. Las funciones para enumerar y recuperar funcionalidades de un dispositivo son accesibles a través del objeto Direct3D. Esto permite a las aplicaciones seleccionar dispositivos sin crearlos.
Cree un objeto IDirect3D9 como se muestra aquí:
LPDIRECT3D9 g_pD3D = NULL;
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
return E_FAIL;
La interfaz IDirect3D9 admite la enumeración de adaptadores de pantalla activos y permite la creación de objetos IDirect3DDevice9 . Si el usuario agrega adaptadores dinámicamente (ya sea agregando dispositivos al escritorio o acoplando en caliente un portátil), esos dispositivos no se incluirán en la enumeración. La creación de una nueva interfaz IDirect3D9 expondrá los nuevos dispositivos.
D3D_SDK_VERSION se pasa a esta función para asegurarse de que los archivos de encabezado en los que se compila una aplicación coinciden con la versión de los archivos DLL en tiempo de ejecución instalados en el equipo. D3D_SDK_VERSION solo se cambia en el tiempo de ejecución cuando un cambio de encabezado (u otro cambio de código) requeriría que se recompile una aplicación. Si se produce un error en esta función, indica que la versión del archivo de encabezado no coincide con la versión del archivo DLL en tiempo de ejecución.
Para obtener un ejemplo, vea Crear un dispositivo (Direct3D 9).
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | d3d9.h (incluya D3D9.h) |
| Library | D3d9.lib |
| Archivo DLL | D3d9.dll |