Método IDebugHostType::GetArrayDimensions (dbgmodel.h)
El método GetArrayDimensions devuelve un conjunto de descriptores, uno para cada dimensión de la matriz, tal como se indica en el método GetArrayDimensionality. Cada descriptor es una estructura ArrayDimension que describe el índice inicial, la longitud y el avance 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.
En el caso de las matrices de estilo C, aquí se devuelve una sola dimensión de matriz 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 Estructuras ArrayDimension que se rellenarán para describir completamente el diseño de la matriz en memoria.
pDimensions
Búfer de dimensiones Estructuras ArrayDimension 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.
Observaciones
de 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 |
|---|---|
| encabezado de | dbgmodel.h |