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

Artigo
08/23/2023

Cria um dispositivo para representar o adaptador de exibição.

Sintaxe

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 o adaptador de exibição. D3DADAPTER_DEFAULT é sempre o adaptador de exibição primário.

[in] DeviceType

Tipo: D3DDEVTYPE

Especifica o tipo de dispositivo. Consulte D3DDEVTYPE. Se o tipo de dispositivo desejado não estiver disponível, o método falhará.

[in] hFocusWindow

Tipo: HWND

A janela de foco alerta o Direct3D quando um aplicativo muda do modo de primeiro plano para o modo em segundo plano. Para o modo de tela inteira, a janela especificada deve ser uma janela de nível superior. Para o modo em janela, esse parâmetro poderá ser NULL somente se o membro hDeviceWindow de pPresentationParameters estiver definido como um valor válido, não NULL .

[in] BehaviorFlags

Tipo: DWORD

Combinação de uma ou mais opções (consulte D3DCREATE) que controlam a criação do dispositivo.

[in, out] pPresentationParameters

Tipo: D3DPRESENT_PARAMETERS*

Ponteiro para uma estrutura D3DPRESENT_PARAMETERS , descrevendo os parâmetros de apresentação para o dispositivo a ser criado. Se BehaviorFlagsespecificar D3DCREATE_ADAPTERGROUP_DEVICE, esse parâmetro será uma matriz. Independentemente do número de cabeças existentes, apenas uma superfície de profundidade/estêncil é criada automaticamente.

Esse parâmetro é uma entrada e um parâmetro de saída. Chamar esse método pode alterar vários membros, incluindo:

Se BackBufferCount, BackBufferWidth e BackBufferHeight forem 0 antes do método ser chamado, eles serão alterados quando o método retornar.
Se BackBufferFormat for igual a D3DFMT_UNKNOWN antes que o método seja chamado, ele será alterado quando o método retornar.

[in, out] pFullscreenDisplayMode

Tipo: D3DDISPLAYMODEEX*

O modo de exibição para quando o dispositivo está definido como tela inteira. Consulte D3DDISPLAYMODEEX. Se BehaviorFlagsespecificar D3DCREATE_ADAPTERGROUP_DEVICE, esse parâmetro será uma matriz. Esse parâmetro deve ser NULL para o modo em janela.

[out, retval] ppReturnedDeviceInterface

Tipo: IDirect3DDevice9Ex**

Endereço de um ponteiro para o IDirect3DDevice9Ex retornado, que representa o dispositivo criado.

Valor retornado

Tipo: HRESULT

Esse método retorna S_OK quando o dispositivo de renderização junto com buffers de swapchain é criado com êxito. D3DERR_DEVICELOST é retornado quando qualquer erro diferente de entrada de chamador inválida é encontrado.

Requisitos


Plataforma de Destino	Windows
Cabeçalho	d3d9.h
Biblioteca	D3D9.lib

Confira também

IDirect3D9Ex

Compartilhar via