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

  • Artigo

Testa o dispositivo para ver se ele dá suporte à conversão de um formato de exibição para outro.

Sintaxe

HRESULT CheckDeviceFormatConversion(
  [in] UINT       Adapter,
  [in] D3DDEVTYPE DeviceType,
  [in] D3DFORMAT  SourceFormat,
  [in] D3DFORMAT  TargetFormat
);

Parâmetros

[in] Adapter

Tipo: UINT

Exibir número ordinal do adaptador. 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] DeviceType

Tipo: D3DDEVTYPE

Tipo de dispositivo. Membro do D3DDEVTYPE tipo enumerado.

[in] SourceFormat

Tipo: D3DFORMAT

Formato do adaptador de origem. Membro do tipo enumerado D3DFORMAT .

[in] TargetFormat

Tipo: D3DFORMAT

Formato do adaptador de destino. Membro do tipo enumerado D3DFORMAT .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado será D3DERR_INVALIDCALL. O método retornará D3DERR_NOTAVAILABLE quando o hardware não der suporte à conversão entre os dois formatos.

Comentários

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 retorno 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.

CheckDeviceFormatConversion também pode ser usado para determinar quais combinações de formatos de superfície de origem e formatos de superfície de destino são permitidas em chamadas para StretchRect.

A conversão de cores é restrita aos seguintes formatos de origem e destino.

  • O formato de origem deve ser um formato FOURCC ou um formato de buffer de fundo válido. Para obter uma lista desses, consulte Formatos FourCC e BackBuffer ou Formatos de exibição.
  • O formato de destino deve ser um destes formatos sem sinal:
    D3DFMT_X1R5G5B5 D3DFMT_A1R5G5B5 D3DFMT_R5G6B5
    D3DFMT_R8G8B8 D3DFMT_X8R8G8B8 D3DFMT_A8R8G8B8
    D3DFMT_A2R10G10B10 D3DFMT_A16B16G16R16 D3DFMT_A2B10G10R10
    D3DFMT_A8B8G8R8 D3DFMT_X8B8G8R8 D3DFMT_A16B16G16R16F
    D3DFMT_A32B32G32R32F
     

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

Colorfill

IDirect3D9