EngAllocPrivateUserMem-Makro (winddi.h)

Artikel
08/27/2023

Die EngAllocPrivateUserMem-Funktion weist einen Block des Benutzerspeichers aus dem Adressraum eines angegebenen Prozesses zu und fügt ein vom Aufrufer bereitgestelltes Tag vor der Zuordnung ein.

Syntax

void EngAllocPrivateUserMem(
  [in]  psl,
  [in]  cj,
  [in]  tag
);

Parameter

[in] psl

Zeiger auf die DD_SURFACE_LOCAL Struktur, die die Microsoft DirectDraw-Oberfläche darstellt, der der zugeordnete Arbeitsspeicher zugeordnet werden soll.

[in] cj

Gibt die Anzahl der Zuteilungsbytes an.

[in] tag

Gibt ein 4-Byte-Pooltag an , das den Treiber eindeutig identifiziert, der die Speicherzuordnung übernimmt. Weitere Informationen zu Pooltags finden Sie unter ExAllocatePoolWithTag.

Rückgabewert

Keine

Bemerkungen

Ein DirectDraw-Treiber erfordert möglicherweise ein "Scratchpad" des Benutzerspeichers anstelle von echtem Videospeicher. Obwohl von dieser Praxis aufgrund ihrer Auswirkungen auf die Leistung abgeraten wird, ist sie gelegentlich notwendig. Dieser Arbeitsspeicher wird in der Regel nur für einen kurzen Zeitraum zugewiesen. Nachdem der Arbeitsspeicher zugewiesen wurde, wird er für die beabsichtigten Grafikvorgänge verwendet und dann zugeordnet.

Ein Problem tritt auf, wenn der Treiber instance zerstört wird, bevor die Oberfläche entsperrt wird. Ein besonderer Fall tritt auf, wenn das System zu einem geschützten Desktop wechselt, weil ein Benutzer STRG+ALT+ENTF drückt. In dieser Situation wird der Modusschalter für einen Systemprozesskontext ausgeführt. Wenn der Treiber über ausstehende Oberflächensperren verfügt, z. B. wenn der Modusschalter vor dem Entsperren des Surface erfolgt, muss der Treiber diese Oberfläche in einem anderen Prozesskontext zerstören. Der Treiber kann EngFreeUserMem nicht aufrufen, um die Zuordnung des Arbeitsspeichers zu beheben, da dieser Einstiegspunkt fehlschlägt, wenn er in einem anderen Kontext aufgerufen wird als der, der bei der Zuweisung des Arbeitsspeichers verwendet wurde.

EngAllocPrivateUserMem und EngFreePrivateUserMem werden bereitgestellt, um dieses Problem zu beheben. Diese beiden Funktionen sind mit EngAllocUserMem und EngFreeUserMem identisch, mit der Ausnahme, dass sie die zusätzliche Arbeit ausführen, die erforderlich ist, um Arbeitsspeicher freizugeben, der für einen anderen Prozesskontext zugewiesen ist. Prozesskontextinformationen werden mit dem DirectDraw-Objekt gespeichert, das das DirectDraw-Oberflächenobjekt besitzt, auf das psl verweist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys