DkmClrModuleInstance.Create Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)
Créez une instance de l’objet DkmClrModuleInstance.
Cette méthode enverra un événement ModuleInstanceLoad.
Contrainte d’emplacement : l’API doit être appelée à partir d’un composant d’analyse (au niveau du composant < 100 000).
public:
static Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleInstance ^ Create(System::String ^ Name, System::String ^ FullName, System::UInt64 TimeDateStamp, Microsoft::VisualStudio::Debugger::DkmModuleVersion ^ Version, Microsoft::VisualStudio::Debugger::Symbols::DkmSymbolFileId ^ SymbolFileId, Microsoft::VisualStudio::Debugger::DkmModuleFlags Flags, Microsoft::VisualStudio::Debugger::DkmModuleMemoryLayout MemoryLayout, System::UInt64 BaseAddress, System::UInt32 LoadOrder, System::UInt32 Size, System::String ^ LoadContext, Microsoft::VisualStudio::Debugger::Clr::DkmClrRuntimeInstance ^ RuntimeInstance, Guid Mvid, Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleFlags ClrFlags, Microsoft::VisualStudio::Debugger::Clr::DkmClrAppDomain ^ AppDomain, bool IsDisabled, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Microsoft::VisualStudio::Debugger::DkmModuleInstance::MinidumpInfo ^ MinidumpInfo, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance Create (string Name, string FullName, ulong TimeDateStamp, Microsoft.VisualStudio.Debugger.DkmModuleVersion Version, Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId SymbolFileId, Microsoft.VisualStudio.Debugger.DkmModuleFlags Flags, Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout MemoryLayout, ulong BaseAddress, uint LoadOrder, uint Size, string LoadContext, Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance RuntimeInstance, Guid Mvid, Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleFlags ClrFlags, Microsoft.VisualStudio.Debugger.Clr.DkmClrAppDomain AppDomain, bool IsDisabled, Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo MinidumpInfo, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : string * string * uint64 * Microsoft.VisualStudio.Debugger.DkmModuleVersion * Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId * Microsoft.VisualStudio.Debugger.DkmModuleFlags * Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout * uint64 * uint32 * uint32 * string * Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance * Guid * Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleFlags * Microsoft.VisualStudio.Debugger.Clr.DkmClrAppDomain * bool * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance
Public Shared Function Create (Name As String, FullName As String, TimeDateStamp As ULong, Version As DkmModuleVersion, SymbolFileId As DkmSymbolFileId, Flags As DkmModuleFlags, MemoryLayout As DkmModuleMemoryLayout, BaseAddress As ULong, LoadOrder As UInteger, Size As UInteger, LoadContext As String, RuntimeInstance As DkmClrRuntimeInstance, Mvid As Guid, ClrFlags As DkmClrModuleFlags, AppDomain As DkmClrAppDomain, IsDisabled As Boolean, Module As DkmModule, MinidumpInfo As DkmModuleInstance.MinidumpInfo, DataItem As DkmDataItem) As DkmClrModuleInstance
Paramètres
- Name
- String
Dans Représentation abrégée du nom du module. Pour les modules basés sur des fichiers, il s’agit du nom de fichier et de l’extension (par exemple : kernel32.dll).
- FullName
- String
Dans Nom complet du module. Pour les modules basés sur des fichiers, il s’agit du chemin d’accès complet au module (par exemple : c:\windows\system32\kernel32.dll.
- TimeDateStamp
- UInt64
Dans Date/heure de la génération du module chargé. Cette valeur est obtenue à partir de la IMAGE_NT_HEADERS du module chargé. L’unité de mesure est une valeur FILETIME, qui est une valeur de 64 bits représentant le nombre d’intervalles de 100 nanosecondes depuis le 1er janvier 1601 (UTC).
- Version
- DkmModuleVersion
[In, facultatif] Informations sur la version du fichier.
- SymbolFileId
- DkmSymbolFileId
[In, facultatif] Contient les informations nécessaires pour localiser les symboles de ce module. Sur Win32, ces informations sont contenues dans le IMAGE_DEBUG_DIRECTORY.
- Flags
- DkmModuleFlags
Dans Indicateurs qui indiquent les traits d’un DkmModuleInstance.
- MemoryLayout
- DkmModuleMemoryLayout
Dans Énumération qui indique comment un module est disposé en mémoire.
- BaseAddress
- UInt64
[In, facultatif] Adresse mémoire de début de l’emplacement de chargement du module. Cette valeur sera égale à zéro si le module n’a pas été chargé dans un bloc de mémoire contigu.
- LoadOrder
- UInt32
Dans Nombre entier du nombre d’instances de module chargées jusqu’à ce module, y compris. Chaque instance du runtime effectue le suivi de son propre nombre d’ordres de chargement.
- Size
- UInt32
[In, facultatif] Nombre d’octets dans la région de mémoire du module. Cette valeur sera égale à zéro si le module n’a pas été chargé dans un bloc de mémoire contigu.
- LoadContext
- String
Dans Description de la chaîne du contexte sous lequel ce module a été chargé. ex : « Win32 » ou « CLR v 2.0.50727 : domaine par défaut ».
- RuntimeInstance
- DkmClrRuntimeInstance
Dans Représente une instance CLR en cours d’exécution dans un processus cible.
- Mvid
- Guid
Dans Identificateur de la version du module à partir du module chargé. Il s’agit d’une valeur unique qui est incorporée dans un fichier exe/dll par des liens/compilateurs lors de la génération de la dll/exe. Une nouvelle valeur est générée chaque fois que la dll/exe est compilée.
- ClrFlags
- DkmClrModuleFlags
Dans Indicateurs qui indiquent les caractéristiques d’un DkmModuleInstance qui a été chargé par le CLR.
- AppDomain
- DkmClrAppDomain
Dans DkmClrAppDomain représente un domaine d’application CLR à l’intérieur d’un processus qui est en cours de débogage.
- IsDisabled
- Boolean
Dans Indique si cette instance de module a été désactivée. Les modules désactivés sont en grande partie ignorés par le débogueur. Pour les modules natifs, la plage d’adresses du module désactivé est traitée comme si elle était démappée. Pour les modules CLR, tous les frames de ces modules sont masqués dans la pile des appels.
- Module
- DkmModule
[In, facultatif] Représentation du gestionnaire de symboles d’un module (DkmModule) qui est associé à cette instance de module. Cette valeur est initialement null et est assignée si les symboles et quand sont associés à cette instance de module.
- MinidumpInfo
- DkmModuleInstance.MinidumpInfo
[In, facultatif] 'MinidumpInfo’est utilisé pour transmettre des informations supplémentaires sur les modules dans un DkmProcess pour un minidump.
- DataItem
- DkmDataItem
[In, facultatif] Objet de données à ajouter à la nouvelle instance DkmClrModuleInstance. Transmettez la valeur null dans le cas où l’appelant n’a pas besoin d’ajouter un élément de données.
Retours
À Résultat de cet appel de méthode.
S’applique à
Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, UInt32, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)
Créez une instance de l’objet DkmClrModuleInstance.
Cette méthode enverra un événement ModuleInstanceLoad.
Contrainte d’emplacement : l’API doit être appelée à partir d’un composant d’analyse (au niveau du composant < 100 000).
Cette API a été introduite dans Visual Studio 12 RTM (DkmApiVersion. VS12RTM).
public:
static Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleInstance ^ Create(System::String ^ Name, System::String ^ FullName, System::UInt64 TimeDateStamp, Microsoft::VisualStudio::Debugger::DkmModuleVersion ^ Version, Microsoft::VisualStudio::Debugger::Symbols::DkmSymbolFileId ^ SymbolFileId, Microsoft::VisualStudio::Debugger::DkmModuleFlags Flags, Microsoft::VisualStudio::Debugger::DkmModuleMemoryLayout MemoryLayout, System::UInt64 BaseAddress, System::UInt32 LoadOrder, System::UInt32 Size, System::String ^ LoadContext, Microsoft::VisualStudio::Debugger::Clr::DkmClrRuntimeInstance ^ RuntimeInstance, Guid Mvid, Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleFlags ClrFlags, Microsoft::VisualStudio::Debugger::Clr::DkmClrAppDomain ^ AppDomain, System::UInt32 ILImageSize, bool IsDisabled, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Microsoft::VisualStudio::Debugger::DkmModuleInstance::MinidumpInfo ^ MinidumpInfo, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance Create (string Name, string FullName, ulong TimeDateStamp, Microsoft.VisualStudio.Debugger.DkmModuleVersion Version, Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId SymbolFileId, Microsoft.VisualStudio.Debugger.DkmModuleFlags Flags, Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout MemoryLayout, ulong BaseAddress, uint LoadOrder, uint Size, string LoadContext, Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance RuntimeInstance, Guid Mvid, Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleFlags ClrFlags, Microsoft.VisualStudio.Debugger.Clr.DkmClrAppDomain AppDomain, uint ILImageSize, bool IsDisabled, Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo MinidumpInfo, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : string * string * uint64 * Microsoft.VisualStudio.Debugger.DkmModuleVersion * Microsoft.VisualStudio.Debugger.Symbols.DkmSymbolFileId * Microsoft.VisualStudio.Debugger.DkmModuleFlags * Microsoft.VisualStudio.Debugger.DkmModuleMemoryLayout * uint64 * uint32 * uint32 * string * Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance * Guid * Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleFlags * Microsoft.VisualStudio.Debugger.Clr.DkmClrAppDomain * uint32 * bool * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance
Public Shared Function Create (Name As String, FullName As String, TimeDateStamp As ULong, Version As DkmModuleVersion, SymbolFileId As DkmSymbolFileId, Flags As DkmModuleFlags, MemoryLayout As DkmModuleMemoryLayout, BaseAddress As ULong, LoadOrder As UInteger, Size As UInteger, LoadContext As String, RuntimeInstance As DkmClrRuntimeInstance, Mvid As Guid, ClrFlags As DkmClrModuleFlags, AppDomain As DkmClrAppDomain, ILImageSize As UInteger, IsDisabled As Boolean, Module As DkmModule, MinidumpInfo As DkmModuleInstance.MinidumpInfo, DataItem As DkmDataItem) As DkmClrModuleInstance
Paramètres
- Name
- String
Dans Représentation abrégée du nom du module. Pour les modules basés sur des fichiers, il s’agit du nom de fichier et de l’extension (par exemple : kernel32.dll).
- FullName
- String
Dans Nom complet du module. Pour les modules basés sur des fichiers, il s’agit du chemin d’accès complet au module (par exemple : c:\windows\system32\kernel32.dll.
- TimeDateStamp
- UInt64
Dans Date/heure de la génération du module chargé. Cette valeur est obtenue à partir de la IMAGE_NT_HEADERS du module chargé. L’unité de mesure est une valeur FILETIME, qui est une valeur de 64 bits représentant le nombre d’intervalles de 100 nanosecondes depuis le 1er janvier 1601 (UTC).
- Version
- DkmModuleVersion
[In, facultatif] Informations sur la version du fichier.
- SymbolFileId
- DkmSymbolFileId
[In, facultatif] Contient les informations nécessaires pour localiser les symboles de ce module. Sur Win32, ces informations sont contenues dans le IMAGE_DEBUG_DIRECTORY.
- Flags
- DkmModuleFlags
Dans Indicateurs qui indiquent les traits d’un DkmModuleInstance.
- MemoryLayout
- DkmModuleMemoryLayout
Dans Énumération qui indique comment un module est disposé en mémoire.
- BaseAddress
- UInt64
[In, facultatif] Adresse mémoire de début de l’emplacement de chargement du module. Cette valeur sera égale à zéro si le module n’a pas été chargé dans un bloc de mémoire contigu.
- LoadOrder
- UInt32
Dans Nombre entier du nombre d’instances de module chargées jusqu’à ce module, y compris. Chaque instance du runtime effectue le suivi de son propre nombre d’ordres de chargement.
- Size
- UInt32
[In, facultatif] Nombre d’octets dans la région de mémoire du module. Cette valeur sera égale à zéro si le module n’a pas été chargé dans un bloc de mémoire contigu.
- LoadContext
- String
Dans Description de la chaîne du contexte sous lequel ce module a été chargé. ex : « Win32 » ou « CLR v 2.0.50727 : domaine par défaut ».
- RuntimeInstance
- DkmClrRuntimeInstance
Dans Représente une instance CLR en cours d’exécution dans un processus cible.
- Mvid
- Guid
Dans Identificateur de la version du module à partir du module chargé. Il s’agit d’une valeur unique qui est incorporée dans un fichier exe/dll par des liens/compilateurs lors de la génération de la dll/exe. Une nouvelle valeur est générée chaque fois que la dll/exe est compilée.
- ClrFlags
- DkmClrModuleFlags
Dans Indicateurs qui indiquent les caractéristiques d’un DkmModuleInstance qui a été chargé par le CLR.
- AppDomain
- DkmClrAppDomain
Dans DkmClrAppDomain représente un domaine d’application CLR à l’intérieur d’un processus qui est en cours de débogage.
- ILImageSize
- UInt32
Dans Spécifie la taille de l’image IL de ce module, car elle se rapporte à la recherche de serveur de symboles. Pour les .NET Framework de bureau, cela permet de spécifier la taille de l’image IL qui sera différente de la taille de l’image brute dans le cas de Ngen. Cela est dû au fait que l’image IL uniquement est celle qui est indexée sur les serveurs de symboles. Pour .NET Core Ngen et prêt à être exécuté, cela permet de spécifier la taille de l’image brute lorsque l’image Ngen/prête à être exécutée est celle qui est indexée et que nous ne souhaitons pas effectuer de recherche en fonction de la taille de l’image IL uniquement.
- IsDisabled
- Boolean
Dans Indique si cette instance de module a été désactivée. Les modules désactivés sont en grande partie ignorés par le débogueur. Pour les modules natifs, la plage d’adresses du module désactivé est traitée comme si elle était démappée. Pour les modules CLR, tous les frames de ces modules sont masqués dans la pile des appels.
- Module
- DkmModule
[In, facultatif] Représentation du gestionnaire de symboles d’un module (DkmModule) qui est associé à cette instance de module. Cette valeur est initialement null et est assignée si les symboles et quand sont associés à cette instance de module.
- MinidumpInfo
- DkmModuleInstance.MinidumpInfo
[In, facultatif] 'MinidumpInfo’est utilisé pour transmettre des informations supplémentaires sur les modules dans un DkmProcess pour un minidump.
- DataItem
- DkmDataItem
[In, facultatif] Objet de données à ajouter à la nouvelle instance DkmClrModuleInstance. Transmettez la valeur null dans le cas où l’appelant n’a pas besoin d’ajouter un élément de données.
Retours
À Résultat de cet appel de méthode.