DXGKDDI_CREATEDEVICE funzione di callback (d3dkmddi.h)

  • Articolo

La funzione DXGKDDI_CREATEDEVICE crea un dispositivo di contesto grafico che viene successivamente usato nelle chiamate alle funzioni specifiche del driver del miniport visualizzato.

Sintassi

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

NTSTATUS DxgkddiCreatedevice(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}

Parametri

hAdapter

[in] Handle a un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport visualizzato in precedenza ha fornito questo handle a Dxgkrnl nel parametro di output MiniportDeviceContext della funzione DXGKDDI_ADD_DEVICE .

pCreateDevice

[in/out] Puntatore a una struttura DXGKARG_CREATEDEVICE che descrive il dispositivo di contesto grafico.

Valore restituito

DXGKDDI_CREATEDEVICE restituisce uno dei valori seguenti:

Codice restituito Descrizione
STATUS_SUCCESS DXGKDDI_CREATEDEVICE creato correttamente il dispositivo contesto grafico.
STATUS_NO_MEMORY DXGKDDI_CREATEDEVICE non è stato possibile allocare memoria necessaria per il completamento.

Commenti

Dxgkrnl chiama la funzione di DXGKDDI_CREATEDEVICE del driver di visualizzazione per creare un dispositivo di contesto grafico che il sottosistema grafico passa successivamente alle chiamate al driver miniport visualizzato. Il driver usa un dispositivo per contenere una raccolta di stato di rendering. Il sottosistema grafico può creare più dispositivi nello stesso processo in una determinata scheda GPU (Graphics Processing Unit).

Nota

Il numero di dispositivi che possono esistere simultaneamente è limitato solo dalla memoria di sistema disponibile. Vale a dire, un driver non può avere un limite massimo di dispositivo hard coded.

In genere, i dispositivi sono indipendenti tra loro; in altre parole, le risorse create in un dispositivo non possono essere a cui fare riferimento o accedere dalle risorse create in un altro dispositivo. Tuttavia, le risorse tra processi sono un'eccezione a questa regola.

DXGKDDI_CREATEDEVICE deve essere reso paginabile.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Piattaforma di destinazione Desktop
Intestazione d3dkmddi.h
IRQL PASSIVE_LEVEL

Vedi anche

DXGKARG_CREATEDEVICE

DXGKDDI_ADD_DEVICE