IWDFMemory::CopyFromMemory-Methode (wudfddi.h)

  • Artikel

Warnung

UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.

Die CopyFromMemory-Methode kopiert Daten sicher aus dem angegebenen Quellpuffer und verhindert Überschreitungen, die der Kopiervorgang andernfalls verursachen könnte.

Syntax

HRESULT CopyFromMemory(
  [in]           IWDFMemory        *Source,
  [in, optional] PWDFMEMORY_OFFSET SourceOffset
);

Parameter

[in] Source

Ein Zeiger auf die IWDFMemory-Schnittstelle für das Speicherobjekt, das die Quelle des Kopiervorgangs ist.

[in, optional] SourceOffset

Ein Zeiger auf eine WDFMEMORY_OFFSET Struktur, die die Informationen beschreibt, die aus einem Speicherblock kopiert werden. Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der gesamte Quellpuffer kopiert wird.

Der BufferOffset-Member der WDFMEMORY_OFFSET-Struktur, wenn nicht NULL, gibt den Offset in den Quellpuffer an, aus dem der Kopiervorgang gestartet werden soll.

Das BufferLength-Element sollte auf 0 festgelegt werden. Das Framework ignoriert diesen Member, da die Menge der kopierten Daten von der Längen- und Offsetkombination des aktuellen Zielpuffers abhängt.

Rückgabewert

CopyFromMemory gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Anforderungen

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform Desktop
UMDF-Mindestversion 1.5
Kopfzeile wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Weitere Informationen