IDXGIFactory::CreateSoftwareAdapter-Methode (dxgi.h)

Erstellen Sie eine Adapterschnittstelle, die einen Softwareadapter darstellt.

Syntax

HRESULT CreateSoftwareAdapter(
        HMODULE      Module,
  [out] IDXGIAdapter **ppAdapter
);

Parameter

Module

Typ: HMODULE

Behandeln Sie die DLL des Softwareadapters. HMODULE kann mit GetModuleHandle oder LoadLibrary abgerufen werden.

[out] ppAdapter

Typ: IDXGIAdapter**

Adresse eines Zeigers auf einen Adapter (siehe IDXGIAdapter).

Rückgabewert

Typ: HRESULT

Ein Rückgabecode , der auf Erfolg oder Fehler hinweist.

Hinweise

Ein Softwareadapter ist eine DLL, die die gesamte Gerätetreiberschnittstelle sowie ggf. die Emulation von Kernelmodusgrafikkomponenten für Windows implementiert. Details zur Implementierung eines Softwareadapters finden Sie im Windows Vista Driver Development Kit. Dies ist eine sehr komplexe Entwicklungsaufgabe und wird für allgemeine Leser nicht empfohlen.

Durch Aufrufen dieser Methode wird die Referenzanzahl des Moduls um eins erhöht. Die Referenzanzahl kann durch Aufrufen von FreeLibrary verringert werden.

Das typische Aufrufszenario besteht darin , LoadLibrary aufzurufen, das Handle an CreateSoftwareAdapter zu übergeben, dann sofort FreeLibrary für die DLL aufzurufen und das HMODULE der DLL zu vergessen. Da der Softwareadapter FreeLibrary aufruft, wenn er zerstört wird, ist die Lebensdauer der DLL nun im Besitz des Adapters, und die Anwendung ist frei von weiteren Überlegungen über ihre Lebensdauer.

Anforderungen

Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib

Weitere Informationen

IDXGIFactory