PFND3DDDI_CREATEDEVICE funzione di callback (d3dumddi.h)

  • Articolo

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)

Vedi anche

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice