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 |