VideoPortAllocateContiguousMemory-Funktion (video.h)

Die VideoPortAllocateContiguousMemory-Funktion ist in Windows 2000 und höher veraltet . Video-Miniporttreiber sollten VideoPortAllocateCommonBuffer an seiner Stelle verwenden.

VideoPortAllocateContiguousMemory weist einen Bereich von physisch zusammenhängendem, cacheorientiertem Speicher aus dem nicht auslagerten Pool zu.

Syntax

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
  [in] IN PVOID            HwDeviceExtension,
  [in] IN ULONG            NumberOfBytes,
  [in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);

Parameter

[in] HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] NumberOfBytes

Gibt die Größe des zuzuordnenden Blocks des zusammenhängenden Arbeitsspeichers in Byte 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 Arbeitsspeicher in den unteren 16 MB verweisen kann, wird dieser Wert auf 0x00000000FFFFFF festgelegt.

Rückgabewert

VideoPortAllocateContiguousMemory gibt die virtuelle Basisadresse für den zugeordneten Arbeitsspeicher zurück, wenn der Aufruf erfolgreich ist. Wenn die Anforderung nicht erfüllt werden kann, wird NULL zurückgegeben.

Hinweise

VideoPortAllocateContiguousMemory kann aufgerufen werden, um einen zusammenhängenden Physischen Speicherblock 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 auslagerte Pool wahrscheinlich fragmentiert wird, wenn das System ausgeführt wird. Wenn der Miniporttreiber entladen wird, muss die Zuordnung des Arbeitsspeichers aufgehoben werden. Zusammenhängende Zuordnungen werden an einem integralen Vielfachen der Datencachezeilengröße des Prozessors ausgerichtet, um Cache- und Kohenzprobleme zu vermeiden.

Anforderungen

Weitere Informationen

VideoPortAllocateBuffer