PFND3DDDI_SUBMITCOMMANDCB funzione di callback (d3dumddi.h)

  • Articolo

pfnSubmitCommandCb viene usato per inviare buffer dei comandi nei contesti che supportano l'indirizzamento virtuale dell'unità di elaborazione grafica (GPU). Questi contesti generano comandi direttamente dalla modalità utente, gestiscono il proprio pool di buffer dei comandi e non usano l'elenco di allocazione o posizione patch.

pfnSubmitCommandCb sostituisce il vecchio pfnRenderCb per tali contesti e deve essere usato al suo posto. I contesti che operano in modalità patch legacy devono continuare a usare il vecchio pfnRenderCb.

Anche se il driver in modalità utente non genera percorsi di patch, deve comunque generare un elenco delle primarie in cui vengono scritte. Gestione memoria video usa l'elenco di allocazioni per determinare a quali allocazioni primarie viene fatto riferimento per la scrittura da ogni buffer di comando. Queste informazioni vengono usate per sincronizzare il rendering con le primarie con le operazioni Flip .

Alcuni driver in modalità kernel necessitano di informazioni dal driver in modalità utente su come inviare un particolare buffer DMA (Direct Memory Access) alla GPU. In Windows Display Driver Model (WDDM) 1.0 queste informazioni sono state inviate dal driver in modalità utente al driver in modalità kernel tramite il buffer dei comandi. Poiché il buffer DMA viene compilato direttamente dal driver in modalità utente e inviato alla GPU senza alcuna modifica, non può più essere usato per inviare informazioni al driver del kernel. Di conseguenza, viene aggiunto un buffer esplicito di dati del driver privato da inviare insieme a un invio. Si noti che questi dati del driver privato sono unidirezionali e il driver in modalità kernel non può restituire informazioni al driver in modalità utente tramite questo buffer.

Sintassi

PFND3DDDI_SUBMITCOMMANDCB Pfnd3dddiSubmitcommandcb;

HRESULT Pfnd3dddiSubmitcommandcb(
  HANDLE hDevice,
  const D3DDDICB_SUBMITCOMMAND *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione.

unnamedParam2

pData [in]

Puntatore a una struttura D3DDDICB_SUBMITCOMMAND che descrive l'operazione da eseguire.

Valore restituito

Se questa funzione di callback ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

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

Vedi anche

D3DDDICB_SUBMITCOMMAND

pfnRenderCb