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) |