hmLoadTopic({
hmKeywords:"is_SetAllocatedImageMem",
hmTitle:"is_SetAllocatedImageMem",
hmDescription:"Die Funktion is_SetAllocatedImageMem() kann auf 64-Bit-Systemen nicht verwendet werden, da auf diesen keine benutzer-allokierten Speicher unterstützt werden.",
hmPrevLink:"is_scaleddoverlay.html",
hmNextLink:"is_setbrightness.html",
hmParentLink:"functiondescription.html",
hmBreadCrumbs:"<a href=\"driverlibrary.html\">Beschreibung der Treiberbibliothek<\/a> &gt; <a href=\"functiondescription.html\">Funktionsbeschreibungen<\/a>",
hmTitlePath:"Beschreibung der Treiberbibliothek > Funktionsbeschreibungen > is_SetAllocatedImageMem",
hmHeader:"<h1 class=\"p_Heading1\" style=\"page-break-after: avoid;\"><span class=\"f_Heading1\">is_SetAllocatedImageMem<\/span><\/h1>\n\r",
hmBody:"<div style=\"text-align: left; text-indent: 0; line-height: 1.44; padding: 0 0 0 0; margin: 0.4375rem 0 0.4375rem 0;\"><table style=\"width:100%; border:none; border-spacing:0; border-collapse:collapse;\">\n\r<tr>\n\r<td style=\"vertical-align:middle; width:4.5000rem; height:3.1250rem; padding:0; border:solid 0.1250rem #008a96; border-top:none; border-bottom:none; border-left:none;\"><p class=\"p_Table_Text\"><img alt=\"hint_info\" style=\"margin:0;width:4.3750rem;height:3.1250rem;border:none\" src=\".\/images\/hint_info.png\"\/><\/p>\n\r<\/td>\n\r<td style=\"vertical-align:middle; height:3.1250rem; padding:0; border:solid 0.1250rem #008a96;\"><p class=\"p_Table_Hint\"><span class=\"f_Table_Hint\">Die Funktion <\/span><span class=\"f_Code_InNormalText\">is_SetAllocatedImageMem()<\/span><span class=\"f_Table_Hint\"> kann auf 64-Bit-Systemen nicht verwendet werden, da auf diesen keine benutzer-allokierten Speicher unterstützt werden.<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<\/table>\n\r<\/div>\n\r<p class=\"p_Paragraph_Heading\" style=\"page-break-after: avoid;\"><span class=\"f_Paragraph_Heading\">Syntax<\/span><\/p>\n\r<p class=\"p_CodeExample\"><span class=\"f_CodeExample\">INT is_SetAllocatedImageMem (HIDS hf, INT width, INT height, INT bitspixel, char* pcImgMem, int* pid)<\/span><\/p>\n\r<p class=\"p_Paragraph_Heading\" style=\"page-break-after: avoid;\"><span class=\"f_Paragraph_Heading\">Beschreibung<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Code_InNormalText\">is_SetAllocatedImageMem()<\/span><span class=\"f_Fliesstext\"> erklärt einen vom Benutzer allozierten Speicher zu einem Speicher, in den digitalisiert werden kann. Der Speicher muss groß genug allozierten worden und muss unbedingt global gesperrt sein! Ein mit <\/span><span class=\"f_Code_InNormalText\">is_SetAllocatedImageMem()<\/span><span class=\"f_Fliesstext\"> angegebener Speicher kann in eine Sequenz eingebaut werden. Der Speicher muss mit <\/span><span class=\"f_Code_InNormalText\"><a href=\"is_freeimagemem.html\" class=\"topiclink\">is_FreeImageMem()<\/a><\/span><span class=\"f_Fliesstext\"> aus der treiberinternen Verwaltung genommen werden, bevor er tatsächlich wieder freigegeben wird. Der allozierte Speicher darf nicht realloziert werden.<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Folgende Reihenfolge ist zu beachten:<\/span><\/p>\n\r<p class=\"p_Fliesstext\" style=\"text-indent: 0; padding-left: 1.2500rem; margin-left: 0;\"><span class=\"f_Fliesstext\" style=\"display:inline-block;width:1.2500rem;margin-left:-1.2500rem\">1.<\/span><span class=\"f_Fliesstext\">Speicher allozieren: <\/span><span class=\"f_Code_InNormalText\">HANDLE hgMem = GlobalAlloc (size);<\/span><span class=\"f_Fliesstext\"> <\/span><\/p><p class=\"p_Fliesstext\" style=\"text-indent: 0; padding-left: 1.2500rem; margin-left: 0;\"><span class=\"f_Fliesstext\" style=\"display:inline-block;width:1.2500rem;margin-left:-1.2500rem\">2.<\/span><span class=\"f_Fliesstext\">Speicher sperren: <\/span><span class=\"f_Code_InNormalText\">char* pcMem = (char*) GlobalLock (hgMem);<\/span><\/p><p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Die Adresse des Speichers wird an den FALCON\/EAGLE-Treiber übergeben. Dies geschieht mit der Funktion <\/span><span class=\"f_Code_InNormalText\">is_SetAllocatedImageMem().<\/span><span class=\"f_Fliesstext\"> Zusätzlich muss wie bei <\/span><span class=\"f_Code_InNormalText\"><a href=\"is_allocimagemem.html\" class=\"topiclink\">is_AllocImageMem()<\/a><\/span><span class=\"f_Fliesstext\"> die Größe des Bildes angegeben werden. Eine Speicher-ID wird zurückgegeben. Diese wird eventuell für andere Funktionen benötigt.<\/span><\/p>\n\r<p class=\"p_CodeExample\"><span class=\"f_CodeExample\">is_SetAllocatedImageMem (hf, width, height, bitspixel, pcMem, &amp;ID);<\/span><\/p>\n\r<div style=\"text-align: left; text-indent: 0; line-height: 1.44; padding: 0 0 0 0; margin: 0.4375rem 0 0.4375rem 0;\"><table style=\"width:100%; border:none; border-spacing:0; border-collapse:collapse;\">\n\r<tr>\n\r<td style=\"vertical-align:middle; width:4.5000rem; height:3.1250rem; padding:0; border:solid 0.1250rem #008a96; border-top:none; border-bottom:none; border-left:none;\"><p class=\"p_Table_Text\"><img alt=\"hint_info\" style=\"margin:0;width:4.3750rem;height:3.1250rem;border:none\" src=\".\/images\/hint_info.png\"\/><\/p>\n\r<\/td>\n\r<td style=\"vertical-align:middle; height:3.1250rem; padding:0; border:solid 0.1250rem #008a96;\"><p class=\"p_Table_Hint\"><span class=\"f_Table_Hint\">size &gt;= (width * height * bitspixel\/8)<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<\/table>\n\r<\/div>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Der Bildspeicher kann nun wie üblich verwendet werden. Sequenzen sind ebenso möglich.<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Der Speicherbereich muss wieder aus der Treiber-Verwaltung genommen werden: <\/span><span class=\"f_CodeExample\">is_FreeImageMem (hf, pcMem, ID);<\/span><br \/>\n\r<span class=\"f_Fliesstext\">Hierbei wird der Speicher jedoch <\/span><span class=\"f_Bold\">nicht<\/span><span class=\"f_Fliesstext\"> freigegeben.<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Der Benutzer muss dafür sorgen, dass der Speicher freigegeben wird:<\/span><\/p>\n\r<p class=\"p_CodeExample\"><span class=\"f_CodeExample\">GlobalUnlock (hgMem);<\/span><\/p>\n\r<p class=\"p_CodeExample\"><span class=\"f_CodeExample\">GlobalFree (hgMem);<\/span><\/p>\n\r<p class=\"p_Paragraph_Heading\" style=\"page-break-after: avoid;\"><span class=\"f_Paragraph_Heading\">Übergabeparameter<\/span><\/p>\n\r<div style=\"text-align: left; text-indent: 0; line-height: 1.44; padding: 0 0 0 0; margin: 0.2500rem 0 0.2500rem 0;\"><table class=\"Alternating\" >\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">hf<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Handle auf Frame Grabber<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">width<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Breite des Bildes<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">height<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Höhe des Bildes<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">bitspixel<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Farbtiefe des Bildes (Bits pro Pixel)<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">pcImgMem<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Zeiger auf den Speicheranfang des allozierten Speichers<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">pid<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Enthält dann die ID für diesen Speicher<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<\/table>\n\r<\/div>\n\r<p class=\"p_Paragraph_Heading\" style=\"page-break-after: avoid;\"><span class=\"f_Paragraph_Heading\">Rückgabewert<\/span><\/p>\n\r<p class=\"p_CodeExample\"><span class=\"f_CodeExample\">IS_SUCCESS, IS_NO_SUCCESS<\/span><\/p>\n\r"
})
