PINT10_ALLOCATE_BUFFER Rückruffunktion (video.h)
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 identisch sein, nachdem VideoPortQueryServices zurückgegeben wird.
[out] Seg
Zeiger auf einen Speicherspeicherort, der die Segmentadresse des zugeordneten Speicherpuffers empfängt.
[out] Off
Zeiger auf einen Speicherspeicherort, der den Offset innerhalb des von *Seg angegebenen Segments des zugeordneten Speicherpuffers empfängt.
[in, out] Length
Zeiger auf einen Speicherspeicherort, der die Länge des angeforderten Speicherpuffers in Bytes enthält, die bis zu 4096 betragen kann. Wenn die Funktion zurückgibt, enthält dieser Speicherspeicherort den Wert 4096, ob der Arbeitsspeicher tatsächlich zugewiesen wurde.
Rückgabewert
Die Int10AllocateBuffer-Funktion gibt bei Erfolg NO_ERROR zurück. Sie gibt STATUS_INSUFFICIENT_RESOURCES zurück, wenn der Puffer zuvor zugewiesen wurde oder wenn eine Puffergröße größer als 4096 Bytes angefordert wird.
Hinweise
Der Videoport implementiert diese Funktion, auf die über einen Zeiger in der VIDEO_PORT_INT10_INTERFACE-Struktur zugegriffen werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | video.h (einschließen von Video.h) |
| IRQL | PASSIVE_LEVEL |