VideoPortReleaseCommonBuffer function (video.h)

The VideoPortReleaseCommonBuffer function frees a common buffer that was previously allocated by VideoPortAllocateCommonBuffer.

Syntax

VIDEOPORT_DEPRECATED VIDEOPORT_API VOID VideoPortReleaseCommonBuffer(
  [in] IN PVOID            HwDeviceExtension,
  [in] IN PVP_DMA_ADAPTER  VpDmaAdapter,
  [in] IN ULONG            Length,
  [in] IN PHYSICAL_ADDRESS LogicalAddress,
  [in] IN PVOID            VirtualAddress,
  [in] IN BOOLEAN          CacheEnabled
);

Parameters

[in] HwDeviceExtension

Pointer to the miniport driver's device extension.

[in] VpDmaAdapter

Pointer to the VP_DMA_ADAPTER structure that represents the bus-master adapter. This is the structure returned after a call to VideoPortGetDmaAdapter.

[in] Length

Specifies the number of bytes of memory to be freed.

[in] LogicalAddress

Specifies the logical address of the buffer to be freed.

[in] VirtualAddress

Pointer to the corresponding virtual address of the allocated memory range. This value was obtained in a prior call to VideoPortAllocateCommonBuffer.

[in] CacheEnabled

Indicates whether the allocated memory is cached. A value of TRUE indicates that the allocated memory is cached.

Return value

None

Remarks

The parameters passed to VideoPortFreeCommonBuffer must match exactly those passed to and returned from VideoPortAllocateCommonBuffer. A driver cannot free only part of an allocated common buffer.

Requirements

See also

VP_DMA_ADAPTER

VideoPortAllocateCommonBuffer

VideoPortGetDmaAdapter