DkmNativeModuleInstance.Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt32, String, DkmNativeRuntimeInstance, UInt64, UInt32, DkmClrHeaderStatus, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem) 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.
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
À Résultat de cet appel de méthode.