Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

 

Composition Setup
 

Функция (метод) GrdCodeLoad загружает код приложения в формате GCEXE во Flash-память GcaRead производит считывание данных из памяти ключа.

Deck of Cards
id001
Card
defaulttrue
labelC
Code Block
languagecpp
int GRD_API GrdCodeLoad(
HANDLE  hGrd,
DWORD   dwAlgoName,
DWORD   dwFileSize,
void    *pFileBuf,
void    *pReserved 
);  		
Expand
titleПараметры функции

hGrd

Хэндл, через который будет выполнена данная операция.

dwAlgoName

Числовое имя алгоритма.

dwFileSize

Размер буфера для чтения GCEXE-файла.

pFileBuf

Буфер для чтения GCEXE-файла.

pReserved

Зарезервировано. Должно быть NULL.

Expand
titleВозвращаемое значение функции

Набор ошибок Guardant API

Expand
titleОписание

Функция GrdCodeLoad служит для загрузки кода пользователя (GCEXE-файл) непосредственно в свободную Flash-память ключа.

Card
labelC#
Code Block
languagec#
public static GrdE GrdCodeLoad(Handle grdHandle, GrdAlgNum algNum, byte[] fileData)
Expand
titleПараметры метода

grdHandle [in] 

Тип: Handle

Нэндл, через который будет выполнена данная операция.

algNum [in]

Тип: GrdAlgNum

Числовое имя алгоритма

fileData [in]

Тип: byte [ ]

Буфер для чтения GCEXE-файла.

Expand
titleВозвращаемое значение метода

Набор ошибок Guardant API

Expand
titleОписание

Метод GrdCodeLoad служит для загрузки кода пользователя (GCEXE-файл) непосредственно в свободную Flash-память ключа.

Card
labelJava
Code Block
languagejava
public static GrdE GrdCodeLoad(Handle grdHandle, int algoNum, byte[] data)
Expand
titleПараметры метода

grdHandle [in] 

Тип: Handle

Нэндл, через который будет выполнена данная операция.

algoNum [in]

Тип: int

Числовое имя алгоритма

data [in]

Тип: byte [ ]

Буфер для чтения GCEXE-файла.

Expand
titleВозвращаемое значение метода

Набор ошибок Guardant API

Expand
titleОписание

Метод GrdCodeLoad служит для загрузки кода пользователя (GCEXE-файл) непосредственно в свободную Flash-память ключа.

 

Функция GcaRead производит считывание данных из памяти ключа.

...

GcaRead(	
  HANDLE hGrd,
  DWORD	dwAddr,
  DWORD	dwLng,
  void	*pData,
  void	*pReserved
);

...

Входные параметрыСм. директорию:
"%Program Files%\Guardant\Guardant 6\%PublicCode%\Samples\ARM\"
Expand
title
Параметры функции

hGrd

не используется

dwAddr

адрес первого считываемого байта в ключе. Вместо значения адреса можно указывать константы, задающие предопределенные адреса стандартных полей. В случае успешного выполнения операции чтения, текущее значение смещения внутри ключа будет передвинуто за конец считанного блока. Это полезно при организации последовательного потокового чтения данных.

dwLng

количество считываемых байтов

pData

адрес буфера для считанных данных

pReserved

зарезервировано. Значение должно быть равно NULL

Expand
title
Выходные параметры
Возвращаемое значение функции

Набор ошибок Guardant API

Cтандартный набор ошибок

Expand
titleОписание

Функция GcaRead позволяет считывать данные из областей памяти ключа, на которые не наложен запрет на чтение. Адрес первого считываемого байта задается параметром dwAddr, количество байт - параметром dwLng. Режим адресации - используется режим адресации SAM). Если функция выполнена успешно, по адресу, заданному параметром pData, будут помещены считанные из ключа данные.

Память для буфера данных должна быть выделена до вызова GcaRead. В этом случае функция возвращает GrdE_OK. В случае если вы попытаетесь прочитать данные из области памяти, на которую наложен запрет на чтение, также будет возвращено GrdE_OK, однако ни один байт прочитан не будет.

Expand
titleПример