IDebugHostType::GetArrayDimensions-Methode (dbgmodel.h)

Die GetArrayDimensions-Methode gibt einen Satz von Deskriptoren zurück, eine für jede Dimension des Arrays, wie durch die GetArrayDimensionality-Methode angegeben. Jeder Deskriptor ist eine ArrayDimension-Struktur, die den Anfangsindex, die Länge und den Vorwärtsschritt jeder Arraydimension beschreibt. Dies ermöglicht Beschreibungen deutlich leistungsstärkerer Arraykonstrukte als im C-Typsystem zulässig sind.

Bei Arrays im C-Stil wird hier eine einzelne Arraydimension mit Werten zurückgegeben, die immer sind:

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

Syntax

HRESULT GetArrayDimensions(
  ULONG64        dimensions,
  ArrayDimension *pDimensions
);

Parameter

dimensions

Gibt die Anzahl der abzurufenden Dimensionsdeskriptoren an. Dies muss der von einem Aufruf von GetArrayDimensionality abgerufene Wert sein. Ein Puffer der Dimensionen ArrayDimension-Strukturen, die ausgefüllt werden, um das Layout des Arrays im Arbeitsspeicher vollständig zu beschreiben.

pDimensions

Ein Puffer der Dimensionen ArrayDimension-Strukturen, die ausgefüllt werden, um das Layout des Arrays im Arbeitsspeicher vollständig zu beschreiben.

Rückgabewert

Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.

Bemerkungen

Beispielcode-

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.
}

Anforderungen

Anforderung	Wert
Header-	dbgmodel.h

Siehe auch

IDebugHostType-Schnittstelle