VSG_NODEFAULT_INSTANCEVSG_NODEFAULT_INSTANCE

Définit par sa présence si une instance par défaut de la vsgdbg, classe classe, qui fournit l’interface de capture par programmation — est fourni.Defines by its presence whether a default instance of the VsgDbg Class class—which provides the programmatic capture interface—is supplied.

SyntaxeSyntax

#define VSG_NODEFAULT_INSTANCE  

ValueValue

Un préprocesseur qui symbole par sa présence ou absence détermine si une instance par défaut de la VsgDbg classe est fournie.A preprocessor symbol that by its presence or absence determines whether a default instance of the VsgDbg class is provided. Si ce symbole est défini, puis aucune instance par défaut de la VsgDbg classe est fournie ; sinon, une instance par défaut est fournie et initialisée avant l’exécution de votre programme.If this symbol is defined, then no default instance of the VsgDbg class is provided; otherwise, a default instance is provided and initialized before your program runs.

L’interface de capture par programmation est fourni via un pointeur qui a une portée globale, g_pVsgDbg.The programmatic capture interface is provided through a pointer that has global scope, g_pVsgDbg.

VsgDbg *g_pVsgDbg;  

NotesRemarks

L’instance par défaut suffit souvent, mais pour utiliser l’interface de capture par programmation à l’intérieur d’une DLL lorsque le périphérique D3D a été créé en dehors de cette DLL, vous devez créer et gérer votre propre instance de la VsgDbg classe.The default instance is often sufficient, but to use the programmatic capture interface inside a DLL when the D3D device has been created outside that DLL, you must create and manage your own instance of the VsgDbg class. Si vous gérez votre propre interface pour l’API de capture par programmation de cette façon, désactiver l’instance par défaut en définissant VSG_NODEFAULT_INSTANCE afin d’éviter la surcharge.If you are managing your own interface to the programmatic capture API in this way, disable the default instance by defining VSG_NODEFAULT_INSTANCE to avoid overhead.

Si l’instance par défaut n’est pas désactivé, il est automatiquement initialisé avant l’exécution de votre programme et est automatiquement détruite lorsque votre programme se termine.If the default instance is not disabled, it is automatically initialized before your program runs and is automatically destroyed when your program ends. Il est inutile d’initialiser ou annuler explicitement l’initialisation de cette instance.You do not have to initialize or uninitialize this instance explicitly.

Pour désactiver l’instance par défaut, vous devez définir VSG_NODEFAULT_INSTANCE avant d’inclure vsgcapture.h dans votre programme.To disable the default instance, you must define VSG_NODEFAULT_INSTANCE before you include vsgcapture.h in your program.

ExempleExample

Cet exemple montre comment désactiver l’instance par défaut :This example shows how to disable the default instance:

// Define VSG_NODEFAULT_INSTANCE before including vsgcapture.h  
#define VSG_NODEFAULT_INSTANCE  

#include <vsgcapture.h>