VRAM_SURFACE_INFO Struktur (ksmedia.h)
Die VRAM_SURFACE_INFO Struktur beschreibt einen Bereich des Systems oder des Anzeigespeichers, in dem ein AVStream-Minidriver Audio- oder Videodaten erfasst.
Syntax
typedef struct {
UINT_PTR hSurface;
LONGLONG VramPhysicalAddress;
DWORD cbCaptured;
DWORD dwWidth;
DWORD dwHeight;
DWORD dwLinearSize;
LONG lPitch;
ULONGLONG ullReserved[16];
} VRAM_SURFACE_INFO, *PVRAM_SURFACE_INFO;
Angehörige
hSurface
Ein Zeiger auf ein Kernelmodushandle, das die VRAM-Oberfläche identifiziert.
VramPhysicalAddress
Dieses Element enthält die physische Adresse der Oberfläche im Anzeigespeicher. Der Minidriver füllt dieses Element im Handler für KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESSaus.
cbCaptured
Dieses Element gibt die Anzahl der Bytes an, die in die VRAM-Oberfläche kopiert wurden. Der Minidriver legt diesen Wert fest.
dwWidth
Dieses Element gibt die Breite der Videodaten in Pixeln an. Der Minidriver legt diesen Wert fest.
dwHeight
Dieses Element gibt die Höhe der Videodaten in Pixel an. Der Minidriver legt diesen Wert fest.
dwLinearSize
Dieses Element gibt die lineare Größe einer nichtectangularen Oberfläche in Bytes an. Der Minidriver legt diesen Wert fest.
lPitch
Dieses Element gibt den Abstand der Oberfläche an; d. h. der Abstand in Byte bis zum Anfang der nächsten Zeile. Dies wird auch als stride der Oberfläche bezeichnet. Der Minidriver legt diesen Wert fest.
ullReserved[16]
Der Minidriver kann dieses Mitglied verwenden, um Informationen über die Oberfläche zu speichern, während er eine KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS Anforderung verarbeitet. Verwenden Sie jedoch Vorsicht; diese Struktur wird nicht über AVStrMiniPinProcess Aufrufe hinweg beibehalten.
Bemerkungen
Wenn der Minidriver VRAM_SURFACE_INFO über einen KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS-Eigenschaftsaufruf empfängt, werden die Elemente, die VramPhysicalAddress in der Memberliste folgen (mit Ausnahme von ullReserved) nulliert. Der Aufnahmetreiber kann erfasste private Daten in diesen Mitgliedern speichern.
AvStream speichert diese Informationen dann im Datenstromheader und gibt sie an den Minidriver in der AVStrMiniPinProcess Rückruffunktion zurück.
Die Daten in diesen Membern bleiben für die Lebensdauer des Datenstromheaders erhalten. Wenn alle Klons gelöscht werden oder der führende Rand erweitert wird, sind diese Daten nicht mehr zugänglich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ksmedia.h (enthalten Ksmedia.h) |