Partager via

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

  • Article

Teste l’appareil pour voir s’il prend en charge la conversion d’un format d’affichage à un autre.

Syntaxe

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

Paramètres

[in] Adapter

Type : UINT

Numéro ordinal de l’adaptateur d’affichage. D3DADAPTER_DEFAULT est toujours l’adaptateur d’affichage principal. Cette méthode retourne D3DERR_INVALIDCALL lorsque cette valeur est égale ou supérieure au nombre de cartes graphiques dans le système.

[in] DeviceType

Type : D3DDEVTYPE

Type d’appareil. Membre du type énuméré D3DDEVTYPE .

[in] SourceFormat

Type : D3DFORMAT

Format de l’adaptateur source. Membre du type énuméré D3DFORMAT .

[in] TargetFormat

Type : D3DFORMAT

Format de l’adaptateur cible. Membre du type énuméré D3DFORMAT .

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour est D3DERR_INVALIDCALL. La méthode retourne D3DERR_NOTAVAILABLE lorsque le matériel ne prend pas en charge la conversion entre les deux formats.

Remarques

L’utilisation de CheckDeviceType pour tester la compatibilité entre une mémoire tampon d’arrière-mémoire qui diffère du format d’affichage renvoie les valeurs appropriées. Cela signifie que l’appel reflète les fonctionnalités de l’appareil. Si l’appareil ne peut pas afficher le format de mémoire tampon d’arrière-garde demandé, l’appel retourne toujours D3DERR_NOTAVAILABLE. Si l’appareil peut afficher au format, mais ne peut pas effectuer la présentation de conversion de couleur, la valeur de retour est également D3DERR_NOTAVAILABLE. Les applications peuvent découvrir la prise en charge matérielle de la présentation elle-même en appelant CheckDeviceFormatConversion. Aucune émulation logicielle pour la présentation de conversion de couleur elle-même ne sera proposée.

CheckDeviceFormatConversion peut également être utilisé pour déterminer quelles combinaisons de formats de surface source et de formats de surface de destination sont autorisées dans les appels à StretchRect.

La conversion de couleurs est limitée aux formats source et cible suivants.

  • Le format source doit être un format FOURCC ou un format de mémoire tampon d’arrière-mémoire valide. Pour obtenir la liste de ces formats, consultez Formats FourCC et BackBuffer ou Formats d’affichage.
  • Le format cible doit être l’un des formats non signés suivants :
    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
     

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

ColorFill

IDirect3D9