USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

is_PersistentMemory(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)

Beschreibung

Mit der Funktion kann der Inhalt des nicht-flüchtigen Benutzerspeichers der Kamera gelesen oder geschrieben werden. In den Benutzerspeicher können neben den fest ab Werk hinterlegten Informationen zusätzliche Nutzerdaten hinterlegt werden, die nicht zyklisch sondern permanent gespeichert werden sollen, wie z. B. Kameraparameter für das Öffnen der Kamera, einmalig ermittelte, permanente Kalibrierdaten, usw.

Abhängig vom Kameramodell steht neben dem bisherigen 64 Byte Speicher ein neuer zusätzlicher 64 kByte Speicher zur Verfügung, der ebenfalls für Nutzerdaten verwendet werden kann. Die folgende Übersicht zeigt, welche Kamerafamilien welche Benutzerspeicher unterstützen.

Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.

Hinweis: Durch die Funktion is_PersistentMemory() werden folgende Funktionen obsolet: •is_ReadEEPROM() •is_WriteEEPROM() Siehe auch: Veraltete Funktionen

Übergabeparameter

hCam	Handle auf Kamera
nCommand IS_PERSISTENT_MEMORY_READ_USER Liest die Daten des Benutzerspeicher aus. IS_PERSISTENT_MEMORY_WRITE_USER Schreibt die Daten in den Benutzerspeicher. IS_PERSISTENT_MEMORY_GET_SIZE_USER Gibt die Größe des Benutzerspeichers zurück (in Bytes). IS_PERSISTENT_MEMORY_READ_USER_EXTENDED Liest die Daten des erweiterten Benutzerspeicher aus. IS_PERSISTENT_MEMORY_WRITE_USER_EXTENDED Schreibt die Daten in den erweiterten Benutzerspeicher. IS_PERSISTENT_MEMORY_GET_SIZE_USER_EXTENDED Gibt die Größe des erweiterten Benutzerspeichers zurück (in Bytes).
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
cbSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.

Inhalte der Struktur IS_PERSISTENT_MEMORY

Rückgabewert

Beispiel

UINT nSize = 0;
nRet = is_PersistentMemory(hCam, IS_PERSISTENT_MEMORY_GET_SIZE_USER, &nSize, sizeof(nSize));
 
// 1 byte termination added to memory size
char* pMemWrite = new char[nSize + 1];
ZeroMemory(pMemWrite, nSize + 1);
 
// Fill the array with random numbers, except termination
for (int i = 0; i < (INT)nSize; i++)
{
pMemWrite [i] = rand();
}
 
// Initialize peristent memory structure. Write from offset 0 nSize bytes into memory.
IS_PERSISTENT_MEMORY nPersistentMemory;
ZeroMemory(&nPersistentMemory, sizeof(nPersistentMemory));
nPersistentMemory.pu8Memory = pMemWrite;
nPersistentMemory.u32Count = nSize;
nPersistentMemory.u32Offset = 0;
 
// Write memory
nRet = is_PersistentMemory(m_hCam, IS_PERSISTENT_MEMORY_WRITE_USER, &nPersistentMemory, sizeof(nPersistentMemory));
delete[]pMemWrite;
 
// Read memory back into new buffer
char* pMemRead = new char[nSize + 1];
ZeroMemory(pMemRead, nSize + 1);
nPersistentMemory.pu8Memory = pMemRead;
nRet = is_PersistentMemory(m_hCam, IS_PERSISTENT_MEMORY_READ_USER, &nPersistentMemory, sizeof(nPersistentMemory));
delete[]pMemRead;