Método IDirect3D9Ex::CreateDeviceEx (d3d9.h)

Crea un dispositivo para representar el adaptador de pantalla.

Sintaxis

HRESULT CreateDeviceEx(
  [in]          UINT                  Adapter,
  [in]          D3DDEVTYPE            DeviceType,
  [in]          HWND                  hFocusWindow,
  [in]          DWORD                 BehaviorFlags,
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [in, out]     D3DDISPLAYMODEEX      *pFullscreenDisplayMode,
  [out, retval] IDirect3DDevice9Ex    **ppReturnedDeviceInterface
);

Parámetros

[in] Adapter

Tipo: UINT

Número ordinal que indica el adaptador de pantalla. D3DADAPTER_DEFAULT siempre es el adaptador de pantalla principal.

[in] DeviceType

Tipo: D3DDEVTYPE

Especifica el tipo de dispositivo. Consulte D3DDEVTYPE. Si el tipo de dispositivo deseado no está disponible, se producirá un error en el método.

[in] hFocusWindow

Tipo: HWND

La ventana de foco alerta a Direct3D cuando una aplicación cambia del modo de primer plano al modo en segundo plano. Para el modo de pantalla completa, la ventana especificada debe ser una ventana de nivel superior. En el modo con ventana, este parámetro puede ser NULL solo si el miembro hDeviceWindow de pPresentationParameters está establecido en un valor válido que no sea NULL .

[in] BehaviorFlags

Tipo: DWORD

Combinación de una o varias opciones (consulte D3DCREATE) que controlan la creación de dispositivos.

[in, out] pPresentationParameters

Tipo: D3DPRESENT_PARAMETERS*

Puntero a una estructura de D3DPRESENT_PARAMETERS , que describe los parámetros de presentación para el dispositivo que se va a crear. Si BehaviorFlags especifica D3DCREATE_ADAPTERGROUP_DEVICE, este parámetro es una matriz. Independientemente del número de cabezales que existen, solo se crea automáticamente una superficie de profundidad/galería de símbolos.

Este parámetro es una entrada y un parámetro de salida. Llamar a este método puede cambiar varios miembros, entre los que se incluyen:

• Si BackBufferCount, BackBufferWidth y BackBufferHeight son 0 antes de llamar al método, se cambiarán cuando el método vuelva.
• Si BackBufferFormat es igual a D3DFMT_UNKNOWN antes de llamar al método , se cambiará cuando el método vuelva.

[in, out] pFullscreenDisplayMode

Tipo: D3DDISPLAYMODEEX*

Modo de visualización para cuando el dispositivo está establecido en pantalla completa. Vea D3DDISPLAYMODEEX. Si BehaviorFlags especifica D3DCREATE_ADAPTERGROUP_DEVICE, este parámetro es una matriz. Este parámetro debe ser NULL para el modo con ventanas.

[out, retval] ppReturnedDeviceInterface

Tipo: IDirect3DDevice9Ex**

Dirección de un puntero al IDirect3DDevice9Ex devuelto, que representa el dispositivo creado.

Valor devuelto

Tipo: HRESULT

Este método devuelve S_OK al representar el dispositivo junto con los búferes de cadena de intercambio se crean correctamente. D3DERR_DEVICELOST se devuelve cuando se encuentra cualquier error que no sea la entrada del autor de la llamada no válida.

Requisitos

Plataforma de destino	Windows
Encabezado	d3d9.h
Library	D3D9.lib

Consulte también

IDirect3D9Ex