Función D3DX10CreateDevice
Cree el mejor dispositivo Direct3D 10 que representa el adaptador de pantalla. Si se puede crear un dispositivo compatible con Direct3D 10.1, será posible adquirir un puntero de interfaz ID3D10Device1 desde el puntero de interfaz de dispositivo devuelto.
Sintaxis
HRESULT D3DX10CreateDevice(
_In_ IDXGIAdapter *pAdapter,
_In_ D3D10_DRIVER_TYPE DriverType,
_In_ HMODULE Software,
_In_ UINT Flags,
_Out_ ID3D10Device **ppDevice
);
Parámetros
-
pAdapter [in]
-
Tipo: IDXGIAdapter*
Puntero al adaptador de pantalla (vea la interfaz IDXGIAdapter ) al crear un dispositivo de hardware; De lo contrario, establezca este parámetro en NULL. Si se especifica NULL al crear un dispositivo de hardware, Direct3D usará el primer adaptador enumerado por la interfaz IDXGIFactory .
-
DriverType [in]
-
Tipo: D3D10_DRIVER_TYPE
Tipo de controlador de dispositivo (consulte la enumeración D3D10_DRIVER_TYPE ). El tipo de controlador determina el tipo de dispositivo que va a crear.
-
Software [in]
-
Tipo: HMODULE
Identificador de un módulo cargado que implementa un controlador de software (como D3D10Ref.dll). Para obtener un identificador, llame a la función GetModuleHandle .
-
Marcas [in]
-
Tipo: UINT
Marcas de creación de dispositivos (consulte la enumeración D3D10_CREATE_DEVICE_FLAG ) que habilitan las capas de API. Estas marcas pueden ser OR bit a bit juntas.
-
ppDevice [out]
-
Tipo: ID3D10Device**
Dirección de un puntero al dispositivo creado (consulte la interfaz ID3D10Device ).
Valor devuelto
Tipo: HRESULT
Esta función devuelve uno de los siguientes códigos de retorno de Direct3D 10.
Comentarios
Esta función intenta crear el mejor dispositivo para el hardware. En primer lugar, la función intenta crear un dispositivo 10.1. Si no se puede crear un dispositivo 10.1, la función intenta crear un dispositivo 10.0. Si ninguno de los dispositivos se crea correctamente, la función devuelve E_FAIL.
Si la aplicación solo necesita crear un dispositivo 10.1 o solo un dispositivo 10.0, use las siguientes funciones en su lugar:
- Use la función D3D10CreateDevice para crear un dispositivo Direct3D 10.0 solo.
- Use la función D3D10CreateDevice1 para crear un dispositivo Direct3D 10.1 solo.
- Use la función D3DX10GetFeatureLevel1 para obtener un puntero de interfaz ID3D10Device1 desde un puntero de interfaz ID3D10Device .
Un dispositivo Direct3D 10.1 solo se puede crear en equipos que ejecutan Windows Vista Service Pack 1 o posterior y con hardware compatible con Direct3D 10.1 instalado. Sin embargo, es legal llamar a esta función en equipos que ejecutan cualquier versión de Windows que tenga instalado el ARCHIVO DLL D3DX10.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
Consulte también