VideoPortAllocatePool-Funktion (video.h)

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:

[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

Weitere Informationen

VideoPortFreePool