Méthode IDebugHostType ::GetArrayDimensions (dbgmodel.h)
La méthode GetArrayDimensions retourne un ensemble de descripteurs, un pour chaque dimension du tableau, comme indiqué par la méthode GetArrayDimensionality. Chaque descripteur est une structure ArrayDimension qui décrit l’index de départ, la longueur et la foulée avant de chaque dimension de tableau. Cela permet de descriptions de constructions de tableau beaucoup plus puissantes que celles autorisées dans le système de type C.
Pour les tableaux de style C, une dimension de tableau unique est retournée ici avec des valeurs qui sont toujours les suivantes :
- LowerBound = 0
- Length = ARRAYSIZE(array)
- Stride = sizeof(elementType)
Syntaxe
HRESULT GetArrayDimensions(
ULONG64 dimensions,
ArrayDimension *pDimensions
);
Paramètres
dimensions
Indique le nombre de descripteurs de dimension à extraire. Il doit s’agir de la valeur acquise à partir d’un appel à GetArrayDimensionality. Mémoire tampon de dimensions structures ArrayDimension qui sera remplie pour décrire entièrement la disposition du tableau en mémoire.
pDimensions
Mémoire tampon de dimensions structures ArrayDimension qui sera remplie pour décrire entièrement la disposition du tableau en mémoire.
Valeur retournée
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Remarques
Exemple de Code
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.
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dbgmodel.h |