VideoPortFreeCommonBuffer function (video.h)

Article
02/22/2024

The VideoPortFreeCommonBuffer function is obsolete and is supported only for backward compatibility with existing drivers. In its place, driver writers should use VideoPortReleaseCommonBuffer.

VideoPortFreeCommonBuffer deallocates system memory that was allocated by a call to VideoPortGetCommonBuffer.

Syntax

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

Parameters

[in] HwDeviceExtension

Pointer to the miniport driver's device extension.

[in] Length

Specifies the number of bytes of memory to be freed.

[in] VirtualAddress

Pointer to the corresponding virtual address of the allocated memory range.

[in] LogicalAddress

Specifies the logical address of the buffer to be freed.

[in] CacheEnabled

Indicates whether the allocated memory is cached.

Return value

None

Remarks

Except for VideoPortGetCommonBuffer's Alignment parameter, all of the parameters used in a call to VideoPortFreeCommonBuffer must have the same values as those used in the previous call to VideoPortGetCommonBuffer.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform	Desktop
Header	video.h (include Video.h)
Library	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL