PFND3DDDI_OFFERALLOCATIONSCB funzione di callback (d3dumddi.h)

Chiamato dal driver di visualizzazione in modalità utente per offrire allocazioni di memoria video per il riutilizzo.

Sintassi

PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;

HRESULT Pfnd3dddiOfferallocationscb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico). Il runtime Direct3D ha passato il driver in modalità utente questo handle come membro hDevice della struttura D3DDDIARG_CREATEDEVICE alla creazione del dispositivo.

unnamedParam2

pData [in]

Puntatore a una struttura D3DDDICB_OFFERALLOCATIONS che definisce le allocazioni di memoria video offerte dal driver.

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Le allocazioni sono state offerte correttamente. Nota: Se il driver non deve chiamare pfnOfferAllocationsCb, deve restituire S_OK.
D3DDDIERR_DEVICEREMOVED	La gestione memoria video o il driver miniport di visualizzazione non è riuscito a completare l'operazione perché si è verificato un evento di arresto Plug and Play (PnP) o un evento TDR (Timeout Detection and Recovery). Nota: Se viene restituito questo codice di errore, la funzione chiamante del driver (in genere la routine pfnOfferResources ) deve restituire questo codice di errore al runtime Direct3D.
E_INVALIDARG	È stato fornito un parametro non valido.

Commenti

Il driver di visualizzazione in modalità utente chiama pfnOfferAllocationsCb per notificare al sottosistema kernel della grafica DirectX Microsoft che, dopo aver completato tutte le operazioni di rendering precedentemente inviate, può offrire la memoria delle allocazioni per altri processi da usare.

Dopo che il driver chiama pfnOfferAllocationsCb per offrire un'allocazione da riutilizzare, deve chiamare pfnReclaimAllocationsCb prima di bloccare l'allocazione o inviarla per le operazioni di rendering.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Desktop
Intestazione	d3dumddi.h (include D3dumddi.h)

Vedi anche

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocationsCb