StorPortFreeDmaMemory function (storport.h)

This function is the extended version of the StorPortFreeContiguousMemorySpecifyCache function. It deallocates a range of noncached memory in the nonpaged portion of the system address space.

Syntax

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

Parameters

[in] HwDeviceExtension

A pointer to the hardware device extension for the host bus adapter (HBA).

[in] BaseAddress

The base virtual address to free.

[in] NumberOfBytes

The number of bytes that are allocated to the request. This must be the same number that was supplied as a parameter when the StorPortAllocateContiguousMemorySpecifyCacheNode routine was previously called.

[in] CacheType

The cache type that is used in the call to the StorPortAllocateContiguousMemorySpecifyCacheNode routine.

[in_opt] PhysicalAddress

The physical address of the starting address of the memory block to be deallocated.

Return value

This function returns a STOR_STATUS code such as one of the following.

Return code Description
STOR_STATUS_NOT_IMPLEMENTED This function is not implemented on the active operating system.
STOR_STATUS_SUCCESS The operation was successful.

Requirements

Requirement Value
Minimum supported client Windows 10 (Version 1803)
Target Platform Universal
Header storport.h

See also

StorPortAllocateContiguousMemorySpecifyCacheNode