StorPortFreeDmaMemory-Funktion (storport.h)

Artikel
02/29/2024

Diese Funktion ist die erweiterte Version der StorPortFreeContiguousMemorySpecifyCache-Funktion. Die Zuordnung eines Bereichs von nicht zwischengespeichertem Arbeitsspeicher im nicht ausgelagerten Teil des Systemadressraums wird aufgehoben.

Syntax

ULONG StorPortFreeDmaMemory(
  [in]     PVOID               HwDeviceExtension,
  [in]     PVOID               BaseAddress,
  [in]     SIZE_T              NumberOfBytes,
  [in]     MEMORY_CACHING_TYPE CacheType,
  [in_opt] PHYSICAL_ADDRESS    PhysicalAddress
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Host bus adapter (HBA).

[in] BaseAddress

Die virtuelle Basisadresse, die freigegeben werden soll.

[in] NumberOfBytes

Die Anzahl der Bytes, die der Anforderung zugeordnet sind. Dies muss dieselbe Zahl sein, die als Parameter angegeben wurde, als die StorPortAllocateContiguousMemorySpecifyCacheNode-Routine zuvor aufgerufen wurde.

[in] CacheType

Der Cachetyp, der beim Aufruf der StorPortAllocateContiguousMemorySpecifyCacheNode-Routine verwendet wird.

[in_opt] PhysicalAddress

Die physische Adresse der Startadresse des Speicherblocks, der aufgehoben werden soll.

Rückgabewert

Diese Funktion gibt einen STOR_STATUS Code zurück, z. B. einen der folgenden.

Rückgabecode	Beschreibung
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert.
STOR_STATUS_SUCCESS	Der Vorgang wurde durchgeführt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 (Version 1803)
Zielplattform	Universell
Header	storport.h

Weitere Informationen

StorPortAllocateContiguousMemorySpecifyCacheNode

Freigeben über