PFND3DDDI_SUBMITCOMMANDCB Rückruffunktion (d3dumddi.h)
pfnSubmitCommandCb wird verwendet, um Befehlspuffer für Kontexte zu übermitteln, die die virtuelle Adressierung der Grafikverarbeitungseinheit (GPU) unterstützen. Diese Kontexte generieren Befehle direkt aus dem Benutzermodus, verwalten ihren eigenen Befehlspufferpool und verwenden keine Zuordnungs- oder Patchspeicherortliste.
pfnSubmitCommandCb ersetzt das alte pfnRenderCb für solche Kontexte und muss an seinem Ort verwendet werden. Kontexte, die im Legacypatchmodus ausgeführt werden, müssen weiterhin das alte pfnRenderCb-verwenden.
Obwohl der Benutzermodustreiber keine Patchspeicherorte generiert, muss er dennoch eine Liste der Primarlisten generieren, in die geschrieben wird. Der Videospeicher-Manager verwendet die Zuordnungsliste, um zu bestimmen, auf welche primären Zuordnungen für das Schreiben durch jeden Befehlspuffer verwiesen wird. Diese Informationen werden verwendet, um das Rendern mit den Primaren mit Flip--Vorgängen zu synchronisieren.
Einige Kernelmodustreiber benötigen Informationen vom Benutzermodustreiber, um einen bestimmten DMA-Puffer (Direct Memory Access) an die GPU zu ü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 keine Informationen über diesen Puffer 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_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |