Metodo IDirect3D9::CheckDeviceFormatConversion (d3d9.h)
Testa il dispositivo per verificare se supporta la conversione da un formato di visualizzazione a un altro.
Sintassi
HRESULT CheckDeviceFormatConversion(
[in] UINT Adapter,
[in] D3DDEVTYPE DeviceType,
[in] D3DFORMAT SourceFormat,
[in] D3DFORMAT TargetFormat
);
Parametri
[in] Adapter
Tipo: UINT
Numero ordinale dell'adattatore di visualizzazione. D3DADAPTER_DEFAULT è sempre la scheda di visualizzazione primaria. Questo metodo restituisce D3DERR_INVALIDCALL quando questo valore è uguale o supera il numero di schede di visualizzazione nel sistema.
[in] DeviceType
Tipo: D3DDEVTYPE
Tipo di dispositivo. Membro del tipo enumerato D3DDEVTYPE .
[in] SourceFormat
Tipo: D3DFORMAT
Formato adattatore di origine. Membro del tipo enumerato D3DFORMAT .
[in] TargetFormat
Tipo: D3DFORMAT
Formato adattatore di destinazione. Membro del tipo enumerato D3DFORMAT .
Valore restituito
Tipo: HRESULT
Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito viene D3DERR_INVALIDCALL. Il metodo restituirà D3DERR_NOTAVAILABLE quando l'hardware non supporta la conversione tra i due formati.
Commenti
L'uso di CheckDeviceType per verificare la compatibilità tra un buffer nascosto diverso dal formato di visualizzazione restituirà i valori appropriati. Ciò significa che la chiamata rifletterà le funzionalità del dispositivo. Se il dispositivo non può eseguire il rendering nel formato del buffer nascosto richiesto, la chiamata restituirà comunque D3DERR_NOTAVAILABLE. Se il dispositivo può eseguire il rendering nel formato, ma non può eseguire la presentazione di conversione dei colori, anche il valore restituito verrà D3DERR_NOTAVAILABLE. Le applicazioni possono individuare il supporto hardware per la presentazione stessa chiamando CheckDeviceFormatConversion. Non verrà offerta alcuna emulazione software per la presentazione di conversione dei colori stessa.
CheckDeviceFormatConversion può essere usato anche per determinare quali combinazioni di formati di superficie di origine e di superficie di destinazione sono consentite nelle chiamate a StretchRect.
La conversione dei colori è limitata ai formati di origine e di destinazione seguenti.
- Il formato di origine deve essere un formato FOURCC o un formato di buffer nascosto valido. Per un elenco di questi formati, vedere Formati FourCC e BackBuffer o Formati di visualizzazione.
- Il formato di destinazione deve essere uno dei formati non firmati seguenti:
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
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d9.h (include D3D9.h) |
| Libreria | D3D9.lib |