Metodo IDirect3DDevice9::ValidateDevice (d3d9helper.h)

Articolo
08/23/2023

Segnala la possibilità del dispositivo di eseguire il rendering delle operazioni e degli argomenti correnti di fusione della trama in un singolo passaggio.

Sintassi

HRESULT ValidateDevice(
  [out, retval] DWORD *pNumPasses
);

Parametri

[out, retval] pNumPasses

Tipo: DWORD*

Puntatore a un valore DWORD per riempire il numero di passaggi di rendering necessari per completare l'effetto desiderato tramite il rendering multipass.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_CONFLICTINGRENDERSTATE, D3DERR_CONFLICTINGTEXTUREFILTER, D3DERR_DEVICELOST, D3DERR_DRIVERINTERNALERROR, D3DERR_TOOMANYOPERATIONS, D3DERR_UNSUPPORTEDALPHAARG, D3DERR_UNSUPPORTEDALPHAOPERATION, D3DERR_UNSUPPORTEDCOLORARG, D3DERR_UNSUPPORTEDCOLOROPERATION, D3DERR_UNSUPPORTEDFACTORVALUE, D3DERR_UNSUPPORTEDTEXTUREFILTER, D3DERR_WRONGTEXTUREFORMAT,.

Commenti

Il metodo IDirect3DDevice9::ValidateDevice deve essere usato per convalidare gli scenari solo quando altre funzionalità sono carenti. Ad esempio, in uno scenario di texturing multistage, è possibile eseguire query sui membri MaxTextureBlendStages e MaxSimultaneousTextures di una struttura D3DCAPS9 per determinare se il texturing multistage è possibile nel dispositivo.

L'hardware corrente non implementa necessariamente tutte le possibili combinazioni di operazioni e argomenti. È possibile determinare se un'operazione di fusione specifica può essere eseguita con gli argomenti specificati impostando l'operazione di blending desiderata e quindi chiamando il metodo IDirect3DDevice9::ValidateDevice .

Il metodo IDirect3DDevice9::ValidateDevice usa gli stati di rendering, le trame e gli stati della trama correnti per eseguire la convalida al momento della chiamata. Le modifiche a questi fattori dopo la chiamata invalidano il risultato precedente e il metodo deve essere chiamato di nuovo prima di eseguire il rendering di una scena.

Per prestazioni ottimali, chiamare IDirect3DDevice9::ValidateDevice in fase di inizializzazione; non usarlo all'interno di un ciclo di rendering.

L'uso di valori iterati diffusi, come argomento o come operazione (D3DTA_DIFFUSED3DTOP_BLENDDIFFUSEALPHA) è raramente supportato nell'hardware corrente. La maggior parte dell'hardware può introdurre dati di colore iterazione solo all'ultima fase dell'operazione di trama.

Provare a specificare la trama (D3DTA_TEXTURE) per ogni fase come primo argomento anziché il secondo argomento.

Molte schede non supportano l'uso di valori diffusi o scalari in fasi di trama arbitrarie. Spesso, queste sono disponibili solo alla prima o all'ultima fase di fusione di trame.

Molte schede non hanno un'unità di fusione associata alla prima trama che è in grado di replicare alfa a canali di colore o invertire l'input. Pertanto, l'applicazione potrebbe dover usare solo la seconda fase di trama, se possibile. In tale hardware, la prima unità è presunta nello stato predefinito, che ha il primo argomento colore impostato su D3DTA_TEXTURE con l'operazione di D3DTOP_SELECTARG1.

Le operazioni sull'alfa di output più complesse o sostanzialmente diverse dalle operazioni di colore sono meno probabile che siano supportate.

Alcuni hardware non supportano l'uso simultaneo di D3DTA_TFACTOR e D3DTA_DIFFUSE.

Molte schede non supportano l'uso simultaneo di più trame e filtro trilineare mipmapped. Se il filtro trilineare è stato richiesto per una trama coinvolta nelle operazioni di fusione multitexture e la convalida non riesce, disattivare il filtro trilineare e revalidate. In questo caso, è possibile eseguire invece il rendering multipass.