PFND3DDDI_CREATEDEVICE funzione di callback (d3dumddi.h)
La funzione CreateDevice crea un contesto grafico a cui si fa 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 . In input, questa struttura contiene informazioni che il driver può usare. In output, il driver specifica 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 è riuscito a allocare la memoria necessaria per il completamento. |
Commenti
Un dispositivo di visualizzazione è un contesto grafico usato per contenere una raccolta di stato di rendering. È possibile creare più dispositivi tramite lo stesso processo in una determinata scheda. Si noti che il numero di dispositivi di visualizzazione che possono esistere contemporaneamente è limitato solo dalla memoria di sistema disponibile. Vale a dire, un driver non può eseguire il hardcode di un limite massimo di dispositivo.
In genere, i dispositivi sono indipendenti tra loro, in modo che le risorse create in un dispositivo non possano essere a cui fare riferimento o accedervi da risorse create in un'altra. Tuttavia, le risorse tra processi sono 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 il dispositivo. Il driver deve chiamare in modo esplicito la funzione pfnCreateContextCb per creare uno o più contesti in base alle esigenze.
Requisiti
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) |