Condividi tramite


Funzione D3DKMTCreateDCFromMemory (d3dkmthk.h)

La funzione D3DKMTCreateDCFromMemory crea un contesto di visualizzazione da un blocco di memoria specificato.

Sintassi

NTSTATUS D3DKMTCreateDCFromMemory(
  D3DKMT_CREATEDCFROMMEMORY *unnamedParam1
);

Parametri

unnamedParam1

pData [in, out]

Puntatore a una struttura D3DKMT_CREATEDCFROMMEMORY che descrive i parametri per la creazione di un contesto di visualizzazione.

Valore restituito

D3DKMTCreateDCFromMemory restituisce uno dei valori seguenti:

Codice restituito Descrizione
STATUS_SUCCESS Il contesto di visualizzazione è stato creato correttamente.
STATUS_INVALID_PARAMETER I parametri sono stati convalidati e sono stati determinati come non corretti.

Questa funzione potrebbe anche restituire altri valori NTSTATUS .

Commenti

Il kernel controlla la memoria a cui fa riferimento il contesto di visualizzazione creato dalla funzione D3DKMTCreateDCFromMemory . È necessario chiamare la funzione D3DKMTDestoryDCFromMemory per liberare la memoria a cui fa riferimento il contesto di visualizzazione. Qualsiasi altro approccio per liberare questa memoria avrà esito negativo.

Durante l'esecuzione della funzione D3DKMTCreateDCFromMemory , il kernel blocca e esegue il probe della memoria a cui si fa riferimento eseguendo una scrittura non thread-safe in ogni pagina nella memoria. Nessun altro thread nel processo deve tentare di accedere a qualsiasi parte di questa memoria per la durata della chiamata D3DKMTCreateDCFromMemory ; in caso contrario, i risultati non saranno definiti.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Piattaforma di destinazione Universale
Intestazione d3dkmthk.h (include D3dkmthk.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

D3DKMT_CREATEDCFROMMEMORY