Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.15. Работа с матрицами и массивами

А.5.15.9. rdsGetVarArrayParams – получить размеры матрицы/массива и указатель на первый элемент

Функция rdsGetVarArrayParams возвращает указатель на первый элемент указанной матрицы или массива, а также, при необходимости, число строк и столбцов этой матрицы.

  LPVOID RDSCALL rdsGetVarArrayParams(
    LPVOID BaseAddr,    // Базовый адрес переменной
    int *pRows,         // Возвращаемое число строк
    int *pCols          // Возвращаемое число столбцов
  );

Тип указателя на эту функцию

RDS_pVpVpIpI

Параметры

BaseAddr (LPVOID)

Указатель (может быть любого типа, в т.ч. и void*) на данные матрицы в дереве переменных блока, то есть указатель на область из восьми байтов, которые эта матрицы занимает в дереве переменных (см. §2.5.3 руководства программиста).

pRows (int*)

Указатель на целую переменную, в которую функция запишет число строк в матрице. Если вызывающей программе не требуется знать число строк, в этом параметре можно передать NULL.

pCols (int*)

Указатель на целую переменную, в которую функция запишет число столбцов в матрице. Если вызывающей программе не требуется знать число столбцов, в этом параметре можно передать NULL.

Возвращаемое значение

Указатель произвольного типа (void*) на первый элемент в матрице, или NULL, если матрица пуста.

Примечания

Эта функция устарела, в настоящее время вместо нее желательно использовать rdsGetVarArrayAccessData.

См. также

RDS_ARRAYACCESSDATA, rdsGetVarArrayAccessData.