DXGKDDI_CREATEDEVICE funzione di callback (d3dkmddi.h)

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

Sintassi

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

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

Parametri

hAdapter

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

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 di contesto grafico.
STATUS_NO_MEMORY	DXGKDDI_CREATEDEVICE non è stato possibile allocare memoria necessaria per il completamento.

Commenti

Dxgkrnl chiama la funzione DXGKDDI_CREATEDEVICE del driver miniport di visualizzazione per creare un dispositivo di contesto grafico che il sottosistema grafico passa successivamente alle chiamate al driver miniport di visualizzazione. 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. Ovvero, un driver non può avere un limite massimo di dispositivi hardcoded.

In genere, i dispositivi sono indipendenti l'uno dall'altro; in altre parole, le risorse create in un dispositivo non possono essere referenziate o accessibili dalle risorse create in un altro dispositivo.In other words, resources that are created in one device cannot be referenced or accessed by resources that are created in another device. Tuttavia, le risorse tra processi rappresentano 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