Versions Compared

Old Version 8

changes.mady.by.user Guardant R&D

Saved on

compared with

New Version Current

changes.mady.by.user Guardant R&D

Saved on

Key

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

...

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

hGrd

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

dwAddr

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

dwLng

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

pData

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

pReserved

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

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

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

Expand
titleОписание

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

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

...