PFND3DDDI_OFFERALLOCATIONS2CB funzione di callback (d3dumddi.h)

Articolo
02/25/2024

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)