IdXGIFactory::CreateSoftwareAdapter, méthode (dxgi.h)
Créez une interface d’adaptateur qui représente un adaptateur logiciel.
Syntaxe
HRESULT CreateSoftwareAdapter(
HMODULE Module,
[out] IDXGIAdapter **ppAdapter
);
Paramètres
Module
Type : HMODULE
Gérez la dll de l’adaptateur logiciel. HMODULE peut être obtenu avec GetModuleHandle ou LoadLibrary.
[out] ppAdapter
Type : IDXGIAdapter**
Adresse d’un pointeur vers un adaptateur (voir IDXGIAdapter).
Valeur retournée
Type : HRESULT
Code de retour indiquant la réussite ou l’échec.
Notes
Un adaptateur logiciel est une DLL qui implémente l’intégralité d’une interface de pilote de périphérique, ainsi que l’émulation, si nécessaire, des composants graphiques en mode noyau pour Windows. Pour plus d’informations sur l’implémentation d’un adaptateur logiciel, consultez le Kit de développement du pilote Windows Vista. Il s’agit d’une tâche de développement très complexe qui n’est pas recommandée pour les lecteurs généraux.
L’appel de cette méthode incrémente le nombre de références du module d’un. Le nombre de références peut être décrémenté en appelant FreeLibrary.
Le scénario d’appel classique consiste à appeler LoadLibrary, à passer le handle à CreateSoftwareAdapter, puis à appeler immédiatement FreeLibrary sur la DLL et à oublier le HMODULE de la DLL. Étant donné que l’adaptateur logiciel appelle FreeLibrary lorsqu’il est détruit, la durée de vie de la DLL appartient désormais à l’adaptateur, et l’application est libre de toute considération supplémentaire de sa durée de vie.
Spécifications
Plateforme cible | Windows |
En-tête | dxgi.h |
Bibliothèque | DXGI.lib |