DkmClrModuleInstance.Create Méthode

Définition

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).

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).

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

DkmClrModuleInstance

À 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

DkmClrModuleInstance

À Résultat de cet appel de méthode.

S’applique à