DkmCustomInstructionSymbol.Create(DkmModule, Guid, ReadOnlyCollection<Byte>, UInt64, ReadOnlyCollection<Byte>) Méthode

Définition

Créez une instance de l’objet DkmCustomInstructionSymbol.

public:
 static Microsoft::VisualStudio::Debugger::CustomRuntimes::DkmCustomInstructionSymbol ^ Create(Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, Guid RuntimeType, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ EntityId, System::UInt64 Offset, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ AdditionalData);
public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomInstructionSymbol Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, Guid RuntimeType, System.Collections.ObjectModel.ReadOnlyCollection<byte> EntityId, ulong Offset, System.Collections.ObjectModel.ReadOnlyCollection<byte> AdditionalData);
static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Guid * System.Collections.ObjectModel.ReadOnlyCollection<byte> * uint64 * System.Collections.ObjectModel.ReadOnlyCollection<byte> -> Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomInstructionSymbol
Public Shared Function Create (Module As DkmModule, RuntimeType As Guid, EntityId As ReadOnlyCollection(Of Byte), Offset As ULong, AdditionalData As ReadOnlyCollection(Of Byte)) As DkmCustomInstructionSymbol

Paramètres

Module
DkmModule

Dans La classe DkmModule représente un bundle de code (par ex., dll ou exe) qui est ou une fois chargé dans un ou plusieurs processus. La classe DkmModule est l’objet central des API de symboles et est 1:1 avec la notation du gestionnaire de symboles de ce qui est chargé. Si un lot de code se charge dans trois processus différents (ou dans le même processus, mais avec trois adresses de base différentes ou trois domaines d’application différents), mais que le gestionnaire de symboles considère que tous ces processus sont identiques, il n’y aura qu’un seul objet de module.

RuntimeType
Guid

Dans L’ID d’exécution identifie l’environnement d’exécution d’un morceau de code particulier. Les ID d’exécution sont utilisés par le répartiteur pour décider de l’analyse à distribuer. Notez que le classement des GUID de l’ID d’exécution est quelque peu significatif, car cela dicte le runtime qui obtient la première capture pendant l’arbitrage. Par conséquent, si l’un d’eux veut déclarer une nouvelle instance du runtime qui repose sur le CLR, l’ID d’exécution doit être inférieur à DkmRuntimeId. CLR.

EntityId
ReadOnlyCollection<Byte>

[In, facultatif] Il s’agit d’une structure de données spécifique au moment de l’exécution que les runtimes personnalisés peuvent utiliser pour stocker l’emplacement de cette instruction. Avec’offset', ce champ est utilisé pour comparer deux instructions du même module.

Offset
UInt64

Dans Avec’EntityId', le champ’offset’est utilisé pour identifier de manière unique une instruction. Cela peut contenir une valeur de pointeur (par exemple, un pointeur vers l’instruction) ou un offset à partir du début de la fonction/module.

AdditionalData
ReadOnlyCollection<Byte>

[In, facultatif] Données supplémentaires spécifiques à l’exécution associées à une adresse. Ces données ne sont pas utilisées lors de la comparaison des adresses.

Retours

DkmCustomInstructionSymbol

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

S’applique à