Condividi tramite

Metodo IDirect3D9::CheckDeviceFormatConversion (d3d9.h)

  • Articolo

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

Vedi anche

ColorFill

IDirect3D9