PINT10_ALLOCATE_BUFFER Rückruffunktion (video.h)

Artikel
02/07/2025

Die Int10AllocateBuffer--Funktion kann verwendet werden, um einen einzelnen 4-KB-Speicherblock im Kontext eines anderen Threads zuzuweisen. Nachdem der Speicherblock zugewiesen wurde, muss er freigegeben werden, bevor ein weiterer Speicherblock zugewiesen werden kann.

Syntax

PINT10_ALLOCATE_BUFFER Pint10AllocateBuffer;

VP_STATUS Pint10AllocateBuffer(
  [in]      IN PVOID Context,
  [out]     OUT PUSHORT Seg,
  [out]     OUT PUSHORT Off,
  [in, out] IN OUT PULONG Length
)
{...}

Parameter

[in] Context

Zeiger auf einen vom Videoporttreiber definierten Kontext für die Schnittstelle. Dies sollte mit dem Wert im Context Member der VIDEO_PORT_INT10_INTERFACE Struktur übereinstimmen, nachdem VideoPortQueryServices zurückgegeben wird.

[out] Seg

Zeigen Sie auf einen Speicherspeicherort, der die Segmentadresse des zugeordneten Speicherpuffers empfängt.

[out] Off

Zeigen Sie auf einen Speicherspeicherort, der den Offset innerhalb des durch *Segangegebenen Segment des zugeordneten Speicherpuffers empfängt.

[in, out] Length

Zeigen Sie auf einen Speicherspeicherort, der die Länge des angeforderten Speicherpuffers in Byte enthält, der so groß wie 4096 sein kann. Wenn die Funktion zurückgegeben wird, enthält dieser Speicherspeicherort den Wert 4096, ob der Speicher tatsächlich zugewiesen wurde.

Rückgabewert

Die Int10AllocateBuffer Funktion gibt nach Erfolg NO_ERROR zurück. Sie gibt STATUS_INSUFFICIENT_RESOURCES zurück, wenn der Puffer zuvor zugewiesen wurde oder eine Puffergröße größer als 4096 Byte angefordert wird.

Bemerkungen

Der Videoport implementiert diese Funktion, auf die über einen Zeiger in der VIDEO_PORT_INT10_INTERFACE-Struktur zugegriffen werden kann.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
IRQL-	PASSIVE_LEVEL

Siehe auch

VIDEO_PORT_INT10_INTERFACE

Freigeben über