IDirect3D9::RegisterSoftwareDevice-Methode (d3d9helper.h)

Registriert ein steckbares Softwaregerät. Softwaregeräte bieten Softwarerasterung, sodass Anwendungen auf eine Vielzahl von Softwarerasterisierern zugreifen können.

Syntax

HRESULT RegisterSoftwareDevice(
  [in] void *pInitializeFunction
);

Parameter

[in] pInitializeFunction

Typ: void*

Zeiger auf die Initialisierungsfunktion für das zu registrierende Softwaregerät.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL. Der Methodenaufruf ist ungültig. Beispielsweise kann der Parameter einer Methode einen ungültigen Wert aufweisen: D3DERR_OUTOFVIDEOMEMORY.

Hinweise

Wenn der Computer des Benutzers keine spezielle Hardwarebeschleunigung für 3D-Vorgänge bietet, emuliert Ihre Anwendung möglicherweise 3D-Hardware in der Software. Softwarerasterungsgeräte emulieren die Funktionen von Farb-3D-Hardware in Software. Ein Softwaregerät wird langsamer ausgeführt als ein Hal. Softwaregeräte nutzen jedoch alle speziellen Anweisungen, die von der CPU unterstützt werden, um die Leistung zu erhöhen. Befehlssätze enthalten den AMD 3DNow! Befehlssatz für einige AMD-Prozessoren und der MMX-Befehlssatz, der von vielen Intel-Prozessoren unterstützt wird. Direct3D verwendet das 3D-Now! Befehlssatz zum Beschleunigen von Transformations- und Beleuchtungsvorgängen und der MMX-Anweisungssatz zur Beschleunigung der Rasterung.

Softwaregeräte kommunizieren mit Direct3D über eine Schnittstelle, die der Hardwaregerätetreiberschnittstelle (DDI) ähnelt.

Softwaregeräte werden von der Anwendung geladen und beim IDirect3D9-Objekt registriert. Direct3D verwendet das Softwaregerät zum Rendern.

Das Direct3D Driver Development Kit (DDK) stellt die Dokumentation und Header für die Entwicklung steckbarer Softwaregeräte bereit.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9helper.h (einschließlich D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3D9