VideoPortFreeDeviceBase-Funktion (video.h)

Die VideoPortFreeDeviceBase-Funktion gibt einen Bereich von busrelativen Geräte-E/A-Ports oder Speicheradressen frei, die zuvor dem Systemadressraum zugeordnet wurden. Dazu wird VideoPortGetDeviceBase aufgerufen.

Syntax

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

Parameter

HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

MappedAddress

Gibt die Basisadresse des zugeordneten Bereichs an, der freigegeben werden soll. Dieser Wert muss mit dem Wert übereinstimmen, der von einem vorherigen Aufruf von VideoPortGetDeviceBase zurückgegeben wurde.

Rückgabewert

Keine

Bemerkungen

VideoPortFreeDeviceBase muss über die HwVidFindAdapter-Funktion des Miniporttreibers aufgerufen werden, wenn der Miniporttreiber bereits einen Adressbereich für einen Adapter zugeordnet hat, den er nicht unterstützt oder nicht mehr verwendet.

In diesem Fall muss der Miniporttreiber auch seinen Anspruch für die entsprechenden Hardwareressourcen in der Registrierung freigeben. Um alle Ansprüche für Ressourcen für einen bestimmten Adapter freizugeben, rufen Sie VideoPortVerifyAccessRanges oder VideoPortGetAccessRanges auf, wobei der NumAccessRanges-Parameter auf Null festgelegt ist. Gehen Sie wie folgt vor, um Ansprüche für ausgewählte Zugriffsbereiche freizugeben:

1. Ändern Sie das Zugriffsbereichsarray der beanspruchten busrelativen Bereiche für den Adapter, indem Sie die RangeLength(en) der entsprechenden Elemente auf Null festlegen. Belassen Sie die aktuelle Spezifikation wie in allen Elementen, für die der Miniporttreiber seine Ansprüche nicht freigibt.
2. Rufen Sie VideoPortVerifyAccessRanges mit diesem geänderten AccessRanges-Array auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	video.h (einschließen von Video.h)
Bibliothek	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Weitere Informationen

HwVidFindAdapter

VideoPortGetAccessRanges

VideoPortGetDeviceBase

VideoPortVerifyAccessRanges