Opérations DrawDib

  • Article

[La fonctionnalité associée à cette page, DrawDib, est une fonctionnalité héritée. Elle a été remplacée par la classe MediaComposition. La classe MediaComposition a été optimisée pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise la classe MediaComposition au lieu de DrawDib, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Vous pouvez accéder à l’ensemble du groupe de fonctions DrawDib à l’aide de la fonction DrawDibOpen . Cette fonction charge la bibliothèque de liens dynamiques (DLL), alloue des ressources de mémoire, crée un contexte d’appareil DrawDib et gère un nombre de références du nombre de contrôleurs de domaine initialisés. DrawDibOpen retourne également un handle du nouveau contrôleur de domaine que vous utilisez avec les autres fonctions DrawDib.

Vous pouvez libérer un contrôleur de domaine DrawDib lorsque vous avez terminé de l’utiliser à l’aide de la fonction DrawDibClose . DrawDibClose décrémente également le nombre de références des applications qui accèdent à la DLL. L’appel à DrawDibClose doit être la dernière fonction DrawDib de votre application.

Vous pouvez créer autant de contrôleurs de domaine DrawDib que vous le souhaitez. Vous pouvez utiliser plusieurs contrôleurs de domaine DrawDib pour dessiner plusieurs bitmaps simultanément. Vous pouvez également créer plusieurs contrôleurs de domaine DrawDib, chacun avec des caractéristiques uniques, afin que votre application puisse choisir, puis utiliser le contrôleur de domaine avec les paramètres les plus appropriés. Par exemple, vous pouvez créer deux contrôleurs de domaine DrawDib dans une application : l’un qui affiche une image à sa résolution normale et l’autre qui affiche une partie agrandie de l’image.

Pour s’exécuter efficacement, les fonctions DrawDib nécessitent des informations sur la carte graphique et son pilote. Le profil d’affichage est obtenu en exécutant une série de tests sur l’adaptateur d’affichage la première fois que la DLL contenant les fonctions DrawDib est accessible pour la première fois. Les fonctions DrawDib utilisent ces informations pour toutes les applications. Vous pouvez répéter ces tests si nécessaire à l’aide de la fonction DrawDibProfileDisplay .

Notes

La récupération et le stockage du profil d’affichage sont généralement une occurrence unique. Toutefois, si les informations de profil sont supprimées ou si un autre pilote d’affichage est installé dans le système, DrawDib réexécutera les tests.

 

À propos des fonctions DrawDib