Condividi tramite


PFND3DKMT_CREATEDCFROMMEMORY funzione di callback (d3dkmthk.h)

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

Sintassi

PFND3DKMT_CREATEDCFROMMEMORY Pfnd3dkmtCreatedcfrommemory;

NTSTATUS Pfnd3dkmtCreatedcfrommemory(
  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 determinati per essere 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 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 verranno definiti.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Piattaforma di destinazione Universale
Intestazione d3dkmthk.h (include D3dkmthk.h)

Vedi anche

D3DKMT_CREATEDCFROMMEMORY