Função D3DX10CreateDevice

  • Artigo

Crie o melhor dispositivo Direct3D 10 que representa o adaptador de vídeo. Se um dispositivo compatível com Direct3D 10.1 puder ser criado, será possível adquirir um ponteiro de interface ID3D10Device1 do ponteiro da interface do dispositivo retornado.

Sintaxe

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*

Ponteiro para o adaptador de exibição (consulte a interface IDXGIAdapter ) ao criar um dispositivo de hardware; caso contrário, defina esse parâmetro como NULL. Se NULL for especificado ao criar um dispositivo de hardware, o Direct3D usará o primeiro adaptador enumerado pela interface IDXGIFactory .

DriverType [in]

Tipo: D3D10_DRIVER_TYPE

O tipo de driver de dispositivo (consulte a enumeração D3D10_DRIVER_TYPE ). O tipo de driver determina o tipo de dispositivo que você criará.

Software [in]

Tipo: HMODULE

Um identificador para um módulo carregado que implementa um driver de software (como D3D10Ref.dll). Para obter um identificador, chame a função GetModuleHandle .

Sinalizadores [in]

Tipo: UINT

Sinalizadores de criação de dispositivo (consulte a enumeração D3D10_CREATE_DEVICE_FLAG ) que habilitam camadas de API. Esses sinalizadores podem ser or'd bit a bit juntos.

ppDevice [out]

Tipo: ID3D10Device**

Endereço de um ponteiro para o dispositivo criado (consulte a interface ID3D10Device ).

Valor retornado

Tipo: HRESULT

Essa função retorna um dos seguintes códigos de retorno do Direct3D 10.

Comentários

Essa função tenta criar o melhor dispositivo para o hardware. Primeiro, a função tenta criar um dispositivo 10.1. Se um dispositivo 10.1 não puder ser criado, a função tentará criar um dispositivo 10.0. Se nenhum dos dispositivos for criado com êxito, a função retornará E_FAIL.

Se o aplicativo precisar criar apenas um dispositivo 10.1 ou apenas um dispositivo 10.0, use as seguintes funções:

Um dispositivo Direct3D 10.1 só pode ser criado em computadores que executam o Windows Vista Service Pack 1 ou posterior e com hardware compatível com Direct3D 10.1 instalado. No entanto, é legal chamar essa função em computadores que executam qualquer versão do Windows que tenha a DLL D3DX10 instalada.

Requisitos

Requisito Valor
parâmetro
D3DX10Core.h

Confira também

Funções Uso Geral