(dbgmodel.h) IDebugHostType::GetArrayDimensions 方法
GetArrayDimensions 方法會傳回一組描述元,一個用於數位的每個維度,如 GetArrayDimensionality 方法所指示。 每個描述項都是 ArrayDimension 結構,描述每個陣列維度的起始索引、長度和向前步距。 這可讓描述比 C 類型系統中允許的更強大的數組建構。
針對 C 樣式陣列,此處會傳回單一陣列維度,其值一律為:
- LowerBound = 0
- Length = ARRAYSIZE (陣列)
- Stride = sizeof (elementType)
語法
HRESULT GetArrayDimensions(
ULONG64 dimensions,
ArrayDimension *pDimensions
);
參數
dimensions
指出要擷取的維度描述項數目。 這必須是從 GetArrayDimensionality 呼叫取得的值。 將會填入維度 ArrayDimension 結構的緩衝區,以完整描述記憶體中陣列的配置。
pDimensions
將會填入維度 ArrayDimension 結構的緩衝區,以完整描述記憶體中陣列的配置。
傳回值
這個方法會傳回表示成功或失敗的 HRESULT。
備註
範例程式碼
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.
}
規格需求
需求 | 值 |
---|---|
標頭 | dbgmodel.h |