Méthode IDirect3D9 ::CheckDeviceFormatConversion (d3d9helper.h)
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 d’affichage dans le système.
[in] DeviceType
Type : D3DDEVTYPE
Type d’appareil. Membre du D3DDEVTYPE type énuméré.
[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 arrière qui diffère du format d’affichage retourne les valeurs appropriées. Cela signifie que l’appel reflète les fonctionnalités de l’appareil. Si l’appareil ne peut pas effectuer le rendu au format de mémoire tampon arrière demandé, l’appel retourne toujours D3DERR_NOTAVAILABLE. Si l’appareil peut effectuer le rendu 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 couleur est limitée aux formats source et cible suivants.
- Le format source doit être un format FOURCC ou un format de mémoire tampon arrière 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 | d3d9helper.h (incluez D3D9.h) |
| Bibliothèque | D3D9.lib |