VideoPortAllocatePool-Funktion (video.h)

Artikel
08/07/2023

Die VideoPortAllocatePool-Funktion weist einen Block des Poolspeichers zu und fügt ein vom Aufrufer bereitgestelltes Tag am Anfang des Arbeitsspeichers 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

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] PoolType

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

Wert	Bedeutung
VpNonPagedPool	Der Pool stammt aus dem nicht auslagerten Arbeitsspeicher.
VpPagedPool	Der Pool stammt aus ausgelagertem Arbeitsspeicher.
VpNonPagedPoolCacheAligned	Der Pool stammt aus cacheorientiertem, nicht auslagerten Arbeitsspeicher.
VpPagedPoolCacheAligned	Der Pool stammt aus cacheorientiertem, ausgelagertem Speicher.

[in] NumberOfBytes

Gibt die Anzahl der Zuteilungsbytes an.

[in] Tag

Gibt ein Aus bis zu vier ASCII-Zeichen bestehendes Vier-Byte-Zuordnungstag an, das den Treiber eindeutig identifiziert, der den Arbeitsspeicher zuteilt. Die Tagzeichenfolge ist durch einzelne 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.

Hinweise

VideoPortAllocatePool soll VideoPortAllocateBuffer ersetzen, das veraltet ist.

Die Tagzeichenfolge sollte in Byteumkehrungsreihenfolge angegeben werden. Es wird empfohlen, dass der erste Buchstabe in der Zeichenfolge (bevor er umgekehrt wird) "D" sein, um einen Anzeigetreiber zu bezeichnen. die anderen drei Bytes sollten als Hinweis auf den Treibernamen dienen. Beispielsweise wird die Tagzeichenfolge "zyxD" als "Dxyz" angezeigt, wenn der Pool dumped wird. Das -Tag wird in einem beliebigen Absturzabbild des systems angezeigt, das auftritt.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows XP und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	video.h (einschließen von Video.h)
Bibliothek	Videoprt.lib
DLL	Videoprt.sys
IRQL	Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.

Weitere Informationen

VideoPortFreePool

Freigeben über