PFND3DDDI_OFFERALLOCATIONS2CB funzione di callback (d3dumddi.h)
Chiamato dal driver di visualizzazione in modalità utente per offrire allocazioni di memoria video per il riutilizzo.
Sintassi
PFND3DDDI_OFFERALLOCATIONS2CB Pfnd3dddiOfferallocations2cb;
HRESULT Pfnd3dddiOfferallocations2cb(
HANDLE hDevice,
const D3DDDICB_OFFERALLOCATIONS2 *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_OFFERALLOCATIONS2 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 pfnOfferAllocations2Cb , deve restituire S_OK. |
| D3DDDIERR_DEVICEREMOVED | La gestione della 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 di rilevamento e ripristino timeout (TDR). Nota: Se viene restituito questo codice di errore, la funzione chiamante del driver (in genere il pfnOfferResources routine) deve restituire questo codice di errore al runtime Direct3D. |
| E_INVALIDARG | È stato specificato un parametro non valido. |
Osservazioni
Il driver di visualizzazione in modalità utente chiama pfnOfferAllocations2Cb di notificare al sottosistema del kernel grafico Microsoft DirectX che, dopo aver completato qualsiasi operazione di rendering inviata in precedenza, può offrire la memoria delle allocazioni per altri processi da usare.
Dopo che il driver chiama pfnOfferAllocations2Cb per offrire un'allocazione da riutilizzare, deve chiamare pfnReclaimAllocations3Cb prima di bloccare l'allocazione o inviarla per le operazioni di rendering.
pfnOfferAllocations2Cb funzioni in modo identico a pfnOfferAllocationsCb, ad eccezione del fatto che prende in considerazione i flag tramite il parametro pData.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10 |
| server minimo supportato | Windows Server 2016 |
| piattaforma di destinazione | Finestre |
| intestazione | d3dumddi.h (include D3dumddi.h) |