Método IDirect3D9::CheckDeviceFormatConversion (d3d9.h)
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 |