RtlMoveMemory: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
Zeile 9: Zeile 9:
 
</PRE>
 
</PRE>
  
 +
Sehr häufig wird die Alias-Deklaration '''CopyMemory''' eingesetzt:
 +
 +
<Pre>
 +
Declare Sub CopyMemory Lib "kernel32.dll" _
 +
            Alias "RtlMoveMemory" ( _
 +
            Dest As Any, _
 +
            Source As Any, _
 +
            ByVal cbCopy As Long)
 +
</Pre>
  
 
==Parameter==
 
==Parameter==
Zeile 40: Zeile 49:
 
==Hinweise==
 
==Hinweise==
  
Zugriffe auf einen nicht allokierten Speicherbereich, z.B. durch falsche Übergabe von Quelle oder Ziel, führen zu einem Zugriffsfehler und Absturz des Programms!<br>
+
Zugriffe auf einen nicht allozierten Speicherbereich, z.B. durch falsche Übergabe von Quelle oder Ziel, führen zu einem Zugriffsfehler und Absturz des Programms!<br>
Die hier abgebildete Deklaration verwendet ByRef As Any Übergabe für Quelle und Ziel. Davon abweichend werden bisweilen auch andere Deklarationen verwendet.
+
In der hier abgebildeten Deklaration wird ByRef As Any bei der Übergabe für Quelle und Ziel verwendet. Davon abweichend werden bisweilen auch andere Deklarationen eingesetzt. Beachte: Für die häufig verwendete Alias-Deklaration '''Copymemory''' wird meist die Funktion RtlMoveMemory eingesetzt. Die etwas schnellere Api-Funktion [[RtlCopymemory]], bei der Quell- und Zielbereich nicht überlappen dürfen, wird nur selten eingesetzt.
  
 
==Betriebssystem==
 
==Betriebssystem==

Version vom 27. März 2007, 14:17 Uhr

Die Funktion RtlMoveMemory kopiert einen Speicherbereich. Ziel- und Quellbereich dürfen sich überlappen.

Declare Sub RtlMoveMemory Lib "kernel32" ( _
                 ByRef Dest As Any, _
                 ByRef Source As Any, _
                 ByVal cbCopy As Long)

Sehr häufig wird die Alias-Deklaration CopyMemory eingesetzt:

Declare Sub CopyMemory Lib "kernel32.dll" _
            Alias "RtlMoveMemory" ( _
            Dest As Any, _
            Source As Any, _
            ByVal cbCopy As Long)

Parameter

Dest

Zeiger auf den Zielspeicher.

Source

Zeiger auf den Quellspeicher.

cbCopy

Anzahl der zu kopierenden Bytes.

Beispiel

Dim lWert1 As Long, lWert2 As Long
Dim sString1 As String, sString2 As String

lWert1 = 123456
'kopieren der 4 Bytes von Wert1 nach Wert2
RtlMoveMemory lWert2, lWert1, LenB(lWert1)
MsgBox lWert2

sString1 = "Test"
sString2 = "    "
'kopieren des Strings, um die automatische VB Unicode konvertierung zu umgehen
'muss hier Quelle und Ziel mit ByVal StrPtr() übergeben werden:
RtlMoveMemory ByVal StrPtr(sString2), ByVal StrPtr(sString1), LenB(sString1)
MsgBox sString2


Hinweise

Zugriffe auf einen nicht allozierten Speicherbereich, z.B. durch falsche Übergabe von Quelle oder Ziel, führen zu einem Zugriffsfehler und Absturz des Programms!
In der hier abgebildeten Deklaration wird ByRef As Any bei der Übergabe für Quelle und Ziel verwendet. Davon abweichend werden bisweilen auch andere Deklarationen eingesetzt. Beachte: Für die häufig verwendete Alias-Deklaration Copymemory wird meist die Funktion RtlMoveMemory eingesetzt. Die etwas schnellere Api-Funktion RtlCopymemory, bei der Quell- und Zielbereich nicht überlappen dürfen, wird nur selten eingesetzt.

Betriebssystem

  • Windows 95 / 98 / Me
  • Windows NT 4.0 / 2000 / XP
  • Windows Vista