VideoPortFreeDeviceBase 函数 (video.h)
VideoPortFreeDeviceBase 函数释放以前映射到系统地址空间的一系列相对于总线的设备 I/O 端口或内存地址。 它通过调用 VideoPortGetDeviceBase 来执行此操作。
语法
VIDEOPORT_DEPRECATED VIDEOPORT_API VOID VideoPortFreeDeviceBase(
PVOID HwDeviceExtension,
PVOID MappedAddress
);
参数
HwDeviceExtension
指向微型端口驱动程序的设备扩展的指针。
MappedAddress
指定要释放的映射范围的基址。 此值必须与之前调用 VideoPortGetDeviceBase 返回的值相同。
返回值
无
备注
如果微型端口驱动程序已经映射了无法支持或不再使用的适配器的地址范围，则必须从微型端口驱动程序的 HwVidFindAdapter 函数调用 VideoPortFreeDeviceBase。
发生这种情况时，微型端口驱动程序还必须在注册表中的相应硬件资源上释放其声明。 若要释放对特定适配器的资源的所有声明，请在将 NumAccessRanges 参数设置为零的情况下调用 VideoPortVerifyAccessRanges 或 VideoPortGetAccessRanges。 若要对所选访问范围发布声明，请执行以下操作：
- 通过将相应元素的 RangeLength () 设置为零，修改适配器的声明的总线相对范围的访问范围数组。 在微型端口驱动程序不会释放其声明的所有元素中，将当前规范保留为原样。
- 使用此修改后的 AccessRanges 数组调用 VideoPortVerifyAccessRanges。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 2000 及更高版本的 Windows 操作系统。 |
| 目标平台 | 桌面 |
| 标头 | video.h (包括 Video.h) |
| Library | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |