PFND3DDDI_CREATEDEVICE funzione di callback (d3dumddi.h)
La funzione CreateDevice crea un contesto grafico a cui viene fatto riferimento nelle chiamate successive.
Sintassi
PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;
HRESULT Pfnd3dddiCreatedevice(
HANDLE hAdapter,
D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}
Parametri
hAdapter
Handle che identifica la scheda grafica.
unnamedParam2
pCreateData [in, out]
Puntatore a una struttura D3DDDIARG_CREATEDEVICE. All'input, questa struttura contiene informazioni che il driver può usare. In caso di output, il driver specifica le informazioni nella struttura che il runtime di Microsoft Direct3D può usare.
Valore restituito
CreateDevice restituisce uno dei valori seguenti:
| codice restituito | Descrizione |
|---|---|
| S_OK | Il contesto grafico viene creato correttamente. |
| E_OUTOFMEMORY | CreateDevice non è stato possibile allocare la memoria necessaria per il completamento. |
Osservazioni
Un dispositivo di visualizzazione è un contesto grafico usato per contenere una raccolta di stato di rendering. È possibile creare più dispositivi con lo stesso processo in una determinata scheda. Si noti che il numero di dispositivi di visualizzazione che possono esistere simultaneamente è limitato solo dalla memoria di sistema disponibile. Ovvero, un driver non può impostare come hardcoded un limite massimo di dispositivi.
In genere, i dispositivi sono indipendenti l'uno dall'altro, in modo che le risorse create in un dispositivo non possano essere referenziate o accessibili da risorse create in un'altra. Tuttavia, le risorse tra processi rappresentano un'eccezione a questa regola.
Quando il runtime Direct3D chiama CreateDevice per creare un dispositivo, il runtime non crea un thread di contesto predefinito dell'unità di elaborazione grafica (GPU) per l'esecuzione del dispositivo. Il driver deve chiamare in modo esplicito la funzione pfnCreateContextCb per creare uno o più contesti in base alle esigenze.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | d3dumddi.h (include D3dumddi.h) |