Compartir a través de

Método IDebugHostType::GetArrayDimensions (dbgmodel.h)

  • Artículo

El método GetArrayDimensions devuelve un conjunto de descriptores, uno para cada dimensión de la matriz, como se indica en el método GetArrayDimensionality. Cada descriptor es una estructura ArrayDimension que describe el índice inicial, la longitud y el paso hacia delante de cada dimensión de matriz. Esto permite descripciones de construcciones de matriz significativamente más eficaces de las permitidas en el sistema de tipos de C.

Para las matrices de estilo C, se devuelve una sola dimensión de matriz aquí con valores que siempre son:

  • LowerBound = 0
  • Length = ARRAYSIZE(array)
  • Stride = sizeof(elementType)

Sintaxis

HRESULT GetArrayDimensions(
  ULONG64        dimensions,
  ArrayDimension *pDimensions
);

Parámetros

dimensions

Indica el número de descriptores de dimensión que se van a capturar. Debe ser el valor adquirido de una llamada a GetArrayDimensionality. Búfer de dimensiones ArrayDimension estructuras que se rellenarán para describir completamente el diseño de la matriz en memoria.

pDimensions

Búfer de dimensiones ArrayDimension estructuras que se rellenarán para describir completamente el diseño de la matriz en memoria.

Valor devuelto

Este método devuelve HRESULT que indica éxito o error.

Comentarios

Código de ejemplo

ComPtr<IDebugHostType> spType; /* get a type for some array (see FindTypeByName) */

ArrayDimension adim;
if (SUCCEEDED(spType->GetArrayDimensions(1, &adim)))
{
    // adim indicates information about the dimension.  For C/C++, length is 
    // the largely relevant field.  C/C++ arrays are always zero based.  The 
    // stride field would indicate the size of the array element type.
}

Requisitos

Requisito Valor
Header dbgmodel.h

Consulte también

Interfaz IDebugHostType