VideoPortFreeDeviceBase function (video.h)

Article
05/26/2021

The VideoPortFreeDeviceBase function frees a range of bus-relative device I/O ports or memory addresses previously mapped into the system address space. It does this by calling VideoPortGetDeviceBase.

Syntax

VIDEOPORT_DEPRECATED VIDEOPORT_API VOID VideoPortFreeDeviceBase(
  PVOID HwDeviceExtension,
  PVOID MappedAddress
);

Parameters

HwDeviceExtension

Pointer to the miniport driver's device extension.

MappedAddress

Specifies the base address of the mapped range to be freed. This value must be the same as the value returned by a preceding call to VideoPortGetDeviceBase.

Return value

None

Remarks

VideoPortFreeDeviceBase must be called from the miniport driver's HwVidFindAdapter function if the miniport driver has already mapped an address range for an adapter it cannot support or does not use any longer.

When this occurs, the miniport driver also must release its claim on the corresponding hardware resources in the registry. To release all claims on resources for a particular adapter, call VideoPortVerifyAccessRanges or VideoPortGetAccessRanges with the NumAccessRanges parameter set to zero. To release claims on selected access ranges, do the following:

Modify the access ranges array of claimed bus-relative ranges for the adapter by setting the appropriate elements' RangeLength(s) to zero. Leave the current specification as is in all elements on which the miniport driver will not release its claims.
Call VideoPortVerifyAccessRanges with this modified AccessRanges array.

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