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:
- Ä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.
- 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 |