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 memoria video o il driver miniport non è stato possibile completare l'operazione perché si è verificato un evento di arresto (PnP) Plug and Play (PnP) o un evento TDR (Timeout Detection and Recovery). Nota: Se viene restituito questo codice di errore, la funzione di chiamata del driver (in genere la routine pfnOfferResources ) deve restituire il codice di errore al runtime Direct3D. |
| E_INVALIDARG | È stato fornito un parametro non valido. |
Commenti
Il driver di visualizzazione in modalità utente chiama pfnOfferAllocations2Cb per notificare al sottosistema del kernel grafico Microsoft DirectX che, dopo aver completato tutte le operazioni di rendering inviate in precedenza, può offrire la memoria delle allocazioni per altri processi da usare.
Dopo che il driver chiama pfnOfferAllocations2Cb per offrire un'allocazione al riutilizzo, deve chiamare pfnReclaimAllocations3Cb prima di bloccare l'allocazione o inviarla per le operazioni di rendering.
pfnOfferAllocations2Cb funziona in modo identico a pfnOfferAllocationsCb, ad eccezione del fatto che prende in considerazione i flag tramite il parametro pData.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 |
| Server minimo supportato | Windows Server 2016 |
| Piattaforma di destinazione | Windows |
| Intestazione | d3dumddi.h (include D3dumddi.h) |