DEBUG_ADDRESS_UNION

Descreve diferentes tipos de endereços.

Sintaxe

public struct DEBUG_ADDRESS_UNION {
   public ADDRESS_KIND dwKind;
   public IntPtr       unionmember;
}

typedef struct _tagDEBUG_ADDRESS_UNION {
   ADDRESS_KIND dwKind;
   union {
      NATIVE_ADDRESS                  addrNative;
      UNMANAGED_ADDRESS_THIS_RELATIVE addrThisRel;
      UNMANAGED_ADDRESS_PHYSICAL      addrUPhysical;
      METADATA_ADDRESS_METHOD         addrMethod;
      METADATA_ADDRESS_FIELD          addrField;
      METADATA_ADDRESS_LOCAL          addrLocal;
      METADATA_ADDRESS_PARAM          addrParam;
      METADATA_ADDRESS_ARRAYELEM      addrArrayElem;
      METADATA_ADDRESS_RETVAL         addrRetVal;
      DWORD                           unused;
   } addr;
} DEBUG_ADDRESS_UNION;

Membros

dwKind
Um valor da enumeração ADDRESS_KIND, especificando como interpretar a união.

addr.addrNative
[Apenas C++] Contém a estrutura NATIVE_ADDRESS se dwKind = ADDRESS_KIND_NATIVE.

addr.addrThisRel
[Apenas C++] Contém a estrutura UNMANAGED_ADDRESS_THIS_RELATIVE se dwKind = ADDRESS_KIND_UNMANAGED_THIS_RELATIVE.

addr.addUPhysical
[Apenas C++] Contém a estrutura UNMANAGED_ADDRESS_PHYSICAL se dwKind = ADDRESS_KIND_UNMANAGED_PHYSICAL.

addr.addrMethod
[Apenas C++] Contém a estrutura METADATA_ADDRESS_METHOD se dwKind = ADDRESS_KIND_METHOD.

addr.addrField
[Apenas C++] Contém a estrutura METADATA_ADDRESS_FIELD se dwKind = ADDRESS_KIND_FIELD.

addr.addrLocal
[Apenas C++] Contém a estrutura METADATA_ADDRESS_LOCAL se dwKind = ADDRESS_KIND_LOCAL.

addr.addrParam
[Apenas C++] Contém a estrutura METADATA_ADDRESS_PARAM se dwKind = ADDRESS_KIND_PARAM.

addr.addrArrayElem
[Apenas C++] Contém a estrutura METADATA_ADDRESS_ARRAYELEM se dwKind = ADDRESS_KIND_ARRAYELEM.

addr.addrRetVal
[Apenas C++] Contém a estrutura METADATA_ADDRESS_RETVAL se dwKind = ADDRESS_KIND_RETVAL.

addr.unused
[Apenas C++] preenchimento.

addr
[Apenas C++] O nome do sindicato.

unionmember
[Apenas C#] Esse valor precisa ser empacotado para o tipo de estrutura apropriado com base em dwKind. Ver Observações para a associação entre dwKind e interpretação do sindicato.

Comentários

Essa estrutura faz parte da estrutura DEBUG_ADDRESS e representa um dos vários tipos diferentes de endereços (a estrutura DEBUG_ADDRESS é preenchida por uma chamada para o GetAddress método).

[Apenas C#] A tabela a seguir mostra como interpretar o membro unionmember para cada tipo de endereço. O exemplo mostra como isso é feito para um tipo de endereço.

Exemplo

Este exemplo mostra como interpretar um tipo de endereço (METADATA_ADDRESS_ARRAYELEM) da estrutura DEBUG_ADDRESS_UNION em C#. Os restantes elementos podem ser interpretados exatamente da mesma maneira.

using System;
using System.Runtime.Interop.Services;
using Microsoft.VisualStudio.Debugger.Interop;

namespace MyPackage
{
    public class MyClass
    {
        public void Interpret(DEBUG_ADDRESS_UNION dau)
        {
            if (dau.dwKind == (uint)enum_ADDRESS_KIND.ADDRESS_KIND_METADATA_ARRAYELEM)
            {
                 METADATA_ADDRESS_ARRAYELEM arrayElem =
                     (METADATA_ADDRESS_ARRAYELEM)Marshal.PtrToStructure(dau.unionmember,
                                 typeof(METADATA_ADDRESS_ARRAYELEM));
            }
        }
    }
}

Requerimentos

Cabeçalho: sh.h

Espaço de nomes: Microsoft.VisualStudio.Debugger.Interop

Montagem: Microsoft.VisualStudio.Debugger.Interop.dll

Ver também

• Estruturas e Sindicatos
• DEBUG_ADDRESS
• ADDRESS_KIND
• GetAddress