PFND3DDDI_SUBMITCOMMANDCB Rückruffunktion (d3dumddi.h)

pfnSubmitCommandCb wird verwendet, um Befehlspuffer für Kontexte zu übermitteln, die die virtuelle Gpu-Adressierung (Graphics Processing Unit) unterstützen. Diese Kontexte generieren Befehle direkt aus dem Benutzermodus, verwalten ihren eigenen Befehlspufferpool und verwenden keine Zuordnungs- oder Patchspeicherortliste.

pfnSubmitCommandCb ersetzt die alte pfnRenderCb durch solche Kontexte und muss an seiner Stelle verwendet werden. Kontexte, die im Legacy-Patchmodus ausgeführt werden, müssen weiterhin die alte pfnRenderCb verwenden.

Obwohl der Benutzermodustreiber keine Patchspeicherorte generiert, muss er dennoch eine Liste der Primärvorgänge generieren, in die geschrieben wird. Der Videospeicher-Manager verwendet die Zuordnungsliste, um zu bestimmen, auf welche primären Zuordnungen für den Schreibvorgang von den einzelnen Befehlspuffern verwiesen wird. Diese Informationen werden verwendet, um das Rendern mit den Primaren mit Flip-Vorgängen zu synchronisieren.

Einige Kernelmodustreiber benötigen Informationen von ihrem Benutzermodustreiber darüber, wie sie einen bestimmten DMA-Puffer (Direct Memory Access) an ihre GPU übermitteln. In Windows Display Driver Model (WDDM) 1.0 wurden diese Informationen vom Benutzermodustreiber über den Befehlspuffer an den Kernelmodustreiber gesendet. Da DMA-Puffer direkt vom Benutzermodustreiber erstellt und ohne Änderung an die GPU übermittelt werden, können sie nicht mehr zum Senden von Informationen an den Kerneltreiber verwendet werden. Daher fügen wir einen expliziten privaten Treiberdatenpuffer hinzu, der zusammen mit einer Übermittlung gesendet werden soll. Beachten Sie, dass diese privaten Treiberdaten unidirektional sind und der Kernelmodustreiber über diesen Puffer keine Informationen an den Benutzermodustreiber zurückgeben kann.

Syntax

PFND3DDDI_SUBMITCOMMANDCB Pfnd3dddiSubmitcommandcb;

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

Parameter

hDevice

Ein Handle für das Anzeigegerät.

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDICB_SUBMITCOMMAND Struktur, die den auszuführenden Vorgang beschreibt.

Rückgabewert

Wenn diese Rückruffunktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDICB_SUBMITCOMMAND

pfnRenderCb