VideoPortAllocatePool-Funktion (video.h)

Artikel
02/07/2025

Die VideoPortAllocatePool--Funktion weist einen Speicherblock des Pools zu und fügt am Anfang des Speichers ein vom Aufrufer bereitgestelltes Tag ein.

Syntax

VIDEOPORT_API PVOID VideoPortAllocatePool(
  [in] IN PVOID        HwDeviceExtension,
  [in] IN VP_POOL_TYPE PoolType,
  [in] IN SIZE_T       NumberOfBytes,
  [in] IN ULONG        Tag
);

Parameter

[in] HwDeviceExtension

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

[in] PoolType

Gibt den Zuteilungstyp des Speicherpools an. Dieser Parameter kann auf einen der folgenden Parameter festgelegt werden:

Wert	Bedeutung
VpNonPagedPool	Der Pool stammt aus nicht seitenseitigem Speicher.
VpPagedPool	Der Pool stammt aus dem ausgelagerten Speicher.
VpNonPagedPoolCacheAligned	Der Pool stammt aus cachebündigem, nicht seitenfreiem Speicher.
VpPagedPoolCacheAligned	Der Pool stammt aus dem zwischengespeicherten, ausgelagerten Speicher.

[in] NumberOfBytes

Gibt die Anzahl der zuzuordnenden Bytes an.

[in] Tag

Gibt ein 4-Byte-Zuordnungstag an, das aus bis zu vier ASCII-Zeichen besteht und den Treiber eindeutig identifiziert, der den Speicher zuteilt. Die Tagzeichenfolge wird durch einfache Anführungszeichen getrennt.

Rückgabewert

Bei erfolgreicher Zuordnung des Speicherpools gibt VideoPortAllocatePool die Adresse des zugeordneten Speicherpools zurück. Andernfalls gibt diese Funktion NULL-zurück.

Bemerkungen

VideoPortAllocatePool soll VideoPortAllocateBufferersetzen, das veraltet ist.

Die Tag- Zeichenfolge sollte in byte-umgekehrter Reihenfolge angegeben werden. Es wird empfohlen, dass der erste Buchstabe in der Zeichenfolge (bevor er umgekehrt wird) "D" sein, um einen Anzeigetreiber anzugeben; die anderen drei Byte sollten als Hinweis auf den Treibernamen dienen. Die Tag- Zeichenfolge "zyxD" wird beispielsweise als "Dxyz" angezeigt, wenn der Pool gedumpt wird. Das Tag wird in einem Absturzabbild des systems angezeigt, das auftritt.

Aufrufer von VideoPortAllocatePool- können bei IRQL = DISPATCH_LEVEL nur ausgeführt werden, wenn die angeforderte PoolType- einer der VpNonPagedXxx--Typen ist. Andernfalls müssen Aufrufer unter IRQL-< DISPATCH_LEVEL ausgeführt werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows XP und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys
IRQL-	Siehe Abschnitt "Hinweise".

Siehe auch

VideoPortFreePool-

Freigeben über