DkmNativeModuleInstance.Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt32, String, DkmNativeRuntimeInstance, UInt64, UInt32, DkmClrHeaderStatus, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem) Méthode

Définition

Créez une instance de l’objet DkmNativeModuleInstance.

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::Native::DkmNativeModuleInstance ^ 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::UInt32 LoadOrder, System::String ^ LoadContext, Microsoft::VisualStudio::Debugger::Native::DkmNativeRuntimeInstance ^ RuntimeInstance, System::UInt64 BaseAddress, System::UInt32 Size, Microsoft::VisualStudio::Debugger::Clr::DkmClrHeaderStatus ClrHeaderStatus, bool IsDisabled, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Microsoft::VisualStudio::Debugger::DkmModuleInstance::MinidumpInfo ^ MinidumpInfo, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Native.DkmNativeModuleInstance 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, uint LoadOrder, string LoadContext, Microsoft.VisualStudio.Debugger.Native.DkmNativeRuntimeInstance RuntimeInstance, ulong BaseAddress, uint Size, Microsoft.VisualStudio.Debugger.Clr.DkmClrHeaderStatus ClrHeaderStatus, 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 * uint32 * string * Microsoft.VisualStudio.Debugger.Native.DkmNativeRuntimeInstance * uint64 * uint32 * Microsoft.VisualStudio.Debugger.Clr.DkmClrHeaderStatus * bool * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.DkmModuleInstance.MinidumpInfo * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Native.DkmNativeModuleInstance
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, LoadOrder As UInteger, LoadContext As String, RuntimeInstance As DkmNativeRuntimeInstance, BaseAddress As ULong, Size As UInteger, ClrHeaderStatus As DkmClrHeaderStatus, IsDisabled As Boolean, Module As DkmModule, MinidumpInfo As DkmModuleInstance.MinidumpInfo, DataItem As DkmDataItem) As DkmNativeModuleInstance

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.

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.

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
DkmNativeRuntimeInstance

Dans Représente le code natif qui s’exécute dans un processus cible.

BaseAddress
UInt64

Dans Adresse mémoire de début de l’emplacement de chargement du module. Cette valeur doit toujours être valide.

Size
UInt32

Dans Nombre d’octets dans la région de mémoire du module.

ClrHeaderStatus
DkmClrHeaderStatus

Dans Contient des informations à partir du champ « Flags » de l’IMAGE_COR20_HEADER du module chargé. Cela indique le type de binaire qui a été chargé.

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 DkmNativeModuleInstance. Transmettez la valeur null dans le cas où l’appelant n’a pas besoin d’ajouter un élément de données.

Retours

DkmNativeModuleInstance

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

S’applique à