Compartir a través de

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

  • Artículo

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 d3d9.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

ColorFill

IDirect3D9