Método IDirect3D9::CheckDeviceType (d3d9.h)

Verifica se um tipo de dispositivo acelerado por hardware pode ser usado nesse adaptador.

Sintaxe

HRESULT CheckDeviceType(
  [in] UINT       Adapter,
  [in] D3DDEVTYPE DevType,
  [in] D3DFORMAT  AdapterFormat,
  [in] D3DFORMAT  BackBufferFormat,
  [in] BOOL       bWindowed
);

Parâmetros

[in] Adapter

Tipo: UINT

Número ordinal que indica o adaptador de exibição para enumerar. D3DADAPTER_DEFAULT é sempre o adaptador de exibição primário. Esse método retorna D3DERR_INVALIDCALL quando esse valor é igual ou excede o número de adaptadores de exibição no sistema.

[in] DevType

Tipo: D3DDEVTYPE

Membro do tipo enumerado D3DDEVTYPE, indicando o tipo de dispositivo a ser marcar.

[in] AdapterFormat

Tipo: D3DFORMAT

Membro do tipo enumerado D3DFORMAT , indicando o formato do modo de exibição do adaptador para o qual o tipo de dispositivo deve ser verificado. Por exemplo, alguns dispositivos funcionarão apenas em modos de 16 bits por pixel.

[in] BackBufferFormat

Tipo: D3DFORMAT

Formato de buffer de fundo. Para obter mais informações sobre formatos, consulte D3DFORMAT. Esse valor deve ser um dos formatos de destino de renderização. Você pode usar GetAdapterDisplayMode para obter o formato atual.

Para aplicativos em janelas, o formato de buffer de fundo não precisará corresponder ao formato do modo de exibição se o hardware der suporte à conversão de cores. O conjunto de possíveis formatos de buffer de fundo é restrito, mas o runtime permitirá que qualquer formato de buffer de fundo válido seja apresentado a qualquer formato de área de trabalho. Há o requisito adicional de que o dispositivo seja operável na área de trabalho porque os dispositivos normalmente não operam em modos de 8 bits por pixel.

Aplicativos de tela inteira não podem fazer conversão de cores.

D3DFMT_UNKNOWN é permitido para o modo em janelas.

[in] bWindowed

Tipo: BOOL

Valor que indica se o tipo de dispositivo será usado no modo de tela inteira ou janela. Se definido como TRUE, a consulta será executada para aplicativos em janelas; caso contrário, esse valor deve ser definido como FALSE.

Valor retornado

Tipo: HRESULT

Se o dispositivo puder ser usado nesse adaptador, D3D_OK será retornado.

D3DERR_INVALIDCALL será retornado se o Adaptador for igual ou exceder o número de adaptadores de vídeo no sistema. D3DERR_INVALIDCALL também será retornado se CheckDeviceType especificar um dispositivo que não existe.

D3DERR_NOTAVAILABLE será retornado se não houver suporte para o formato de buffer de retorno solicitado ou se a aceleração de hardware não estiver disponível para os formatos especificados.

Comentários

Um tipo de dispositivo hal requer aceleração de hardware. Os aplicativos podem usar CheckDeviceType para determinar se o hardware e os drivers necessários estão presentes para dar suporte a um dispositivo hal.

Aplicativos de tela inteira não devem especificar um DisplayFormat que contenha um canal alfa. Isso resultará em uma chamada com falha. Observe que um canal alfa pode estar presente no buffer de fundo, mas os dois formatos de exibição devem ser idênticos em todos os outros aspectos. Por exemplo, se DisplayFormat = D3DFMT_X1R5G5B5, os valores válidos para BackBufferFormat incluirão D3DFMT_X1R5G5B5 e D3DFMT_A1R5G5B5, mas excluir D3DFMT_R5G6B5.

O fragmento de código a seguir mostra como você pode usar CheckDeviceType para testar se um determinado tipo de dispositivo pode ser usado nesse adaptador.

if(SUCCEEDED(pD3Device->CheckDeviceType(D3DADAPTER_DEFAULT, 
                                        D3DDEVTYPE_HAL, 
                                        DisplayFormat, 
                                        BackBufferFormat, 
                                        bIsWindowed)))
    
     return S_OK;
// There is no HAL on this adapter using this render-target format. 
// Try again, using another format.

Esse código retornará S_OK se o dispositivo puder ser usado no adaptador padrão com o formato de superfície especificado.

O uso de CheckDeviceType para testar a compatibilidade entre um buffer de fundo diferente do formato de exibição retornará os valores apropriados. Isso significa que a chamada refletirá os recursos do dispositivo. Se o dispositivo não puder renderizar para o formato de buffer de fundo solicitado, a chamada ainda retornará D3DERR_NOTAVAILABLE. Se o dispositivo puder renderizar para o formato, mas não puder executar a apresentação de conversão de cores, o valor retornado também será D3DERR_NOTAVAILABLE. Os aplicativos podem descobrir o suporte de hardware para a apresentação em si chamando CheckDeviceFormatConversion. Nenhuma emulação de software para a apresentação de conversão de cores em si será oferecida.

Requisitos

Confira também

IDirect3D9