VideoPortFreeDeviceBase-Funktion (video.h)
Die VideoPortFreeDeviceBase Funktion gibt eine Reihe von busrelativen Geräte-E/A-Ports oder Speicheradressen frei, die zuvor dem Systemadressraum zugeordnet wurden. Dazu rufen Sie VideoPortGetDeviceBaseauf.
Syntax
VIDEOPORT_DEPRECATED VIDEOPORT_API VOID VideoPortFreeDeviceBase(
PVOID HwDeviceExtension,
PVOID MappedAddress
);
Parameter
HwDeviceExtension
Zeigen Sie 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 durch einen vorherigen Aufruf von VideoPortGetDeviceBasezurückgegeben wird.
Rückgabewert
Nichts
Bemerkungen
VideoPortFreeDeviceBase- muss vom HwVidFindAdapter-Funktion des Miniporttreibers aufgerufen werden, wenn der Miniporttreiber bereits einen Adressbereich für einen Adapter zugeordnet hat, der nicht unterstützt oder nicht mehr verwendet wird.
In diesem Fall muss der Miniporttreiber auch seinen Anspruch auf 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-(s) auf Null festlegen. Belassen Sie die aktuelle Spezifikation wie in allen Elementen, für die der Miniporttreiber seine Ansprüche nicht freigeben wird.
- Rufen Sie VideoPortVerifyAccessRanges mit diesem geänderten AccessRanges Array auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |
| Library | Videoprt.lib |
| DLL- | Videoprt.sys |
| IRQL- | PASSIVE_LEVEL |