VideoPortAllocateContiguousMemory-Funktion (video.h)
Die VideoPortAllocateContiguousMemory Funktion ist veraltete in Windows 2000 und höher. Video-Miniporttreiber sollten VideoPortAllocateCommonBuffer- an seinem Ort verwenden.
VideoPortAllocateContiguousMemory einen Bereich von physisch zusammenhängendem, zwischengespeichertem Speicher aus dem nichtpageten Pool zuordnet.
Syntax
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG NumberOfBytes,
[in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);
Parameter
[in] HwDeviceExtension
Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.
[in] NumberOfBytes
Gibt die Größe in Byte des Zuteilungsspeicherblocks an.
[in] HighestAcceptableAddress
Gibt die höchste gültige physische Adresse an, die der Miniporttreiber verwenden kann. Wenn ein Gerät beispielsweise nur auf physischen Speicher in der unteren 16 MB verweisen kann, wird dieser Wert auf 0x00000000FFFFFF festgelegt.
Rückgabewert
VideoPortAllocateContiguousMemory die virtuelle Basisadresse für den zugewiesenen Speicher zurück, wenn der Aufruf erfolgreich ist. Wenn die Anforderung nicht erfüllt werden kann, wird NULL- zurückgegeben.
Bemerkungen
VideoPortAllocateContiguousMemory- kann aufgerufen werden, um einen zusammenhängenden Block physischen Speichers für einen langfristigen internen Puffer zuzuweisen.
Ein Miniporttreiber, der zusammenhängenden Arbeitsspeicher verwenden muss, sollte nur das zuordnen, was er während der Treiberinitialisierung benötigt, da der nicht seitenseitige Pool wahrscheinlich fragmentiert wird, während das System ausgeführt wird. Wenn der Miniporttreiber entladen wird, muss er den Speicher neu zuweisen. Zusammenhängende Zuordnungen werden an einem integralen Vielfachen der Datencachezeilengröße des Prozessors ausgerichtet, um Cache- und Kohärenzprobleme zu vermeiden.
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 |