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

Voir aussi

IDXGIFactory