Método IDirect3D9::CheckDeviceFormatConversion (d3d9helper.h)
Comprueba el dispositivo para ver si admite la conversión de un formato de pantalla a otro.
Sintaxis
HRESULT CheckDeviceFormatConversion(
[in] UINT Adapter,
[in] D3DDEVTYPE DeviceType,
[in] D3DFORMAT SourceFormat,
[in] D3DFORMAT TargetFormat
);
Parámetros
[in] Adapter
Tipo: UINT
Número ordinal del adaptador de pantalla. D3DADAPTER_DEFAULT siempre es el adaptador de pantalla principal. Este método devuelve D3DERR_INVALIDCALL cuando este valor es igual o supera el número de adaptadores de pantalla del sistema.
[in] DeviceType
Tipo: D3DDEVTYPE
Tipo de dispositivo. Miembro del tipo enumerado D3DDEVTYPE .
[in] SourceFormat
Tipo: D3DFORMAT
Formato del adaptador de origen. Miembro del tipo enumerado D3DFORMAT .
[in] TargetFormat
Tipo: D3DFORMAT
Formato del adaptador de destino. Miembro del tipo enumerado D3DFORMAT .
Valor devuelto
Tipo: HRESULT
Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, se D3DERR_INVALIDCALL el valor devuelto. El método devolverá D3DERR_NOTAVAILABLE cuando el hardware no admita la conversión entre los dos formatos.
Comentarios
El uso de CheckDeviceType para probar la compatibilidad entre un búfer de reserva que difiere del formato de presentación devolverá los valores adecuados. Esto significa que la llamada reflejará las funcionalidades del dispositivo. Si el dispositivo no se puede representar en el formato de búfer de reserva solicitado, la llamada seguirá devolviendo D3DERR_NOTAVAILABLE. Si el dispositivo se puede representar en el formato, pero no puede realizar la presentación de conversión de color, el valor devuelto también se D3DERR_NOTAVAILABLE. Las aplicaciones pueden detectar la compatibilidad de hardware con la propia presentación llamando a CheckDeviceFormatConversion. No se ofrecerá ninguna emulación de software para la presentación de conversión de colores.
CheckDeviceFormatConversion también se puede usar para determinar qué combinaciones de formatos de superficie de origen y formatos de superficie de destino están permitidos en llamadas a StretchRect.
La conversión de color está restringida a los siguientes formatos de origen y destino.
- El formato de origen debe ser un formato FOURCC o un formato de búfer de reserva válido. Para obtener una lista de ellas, consulte Formatos FourCC y BackBuffer o Formatos de presentación.
- El formato de destino debe ser uno de estos formatos sin firmar:
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 | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | d3d9helper.h (incluya D3D9.h) |
| Library | D3D9.lib |