estructura VRAM_SURFACE_INFO (ksmedia.h)
La estructura VRAM_SURFACE_INFO describe una región del sistema o memoria de visualización en la que un minidriver AVStream captura datos de audio o vídeo.
Sintaxis
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;
Miembros
hSurface
Puntero a un identificador de modo kernel que identifica la superficie VRAM.
VramPhysicalAddress
Este miembro contiene la dirección física de la superficie en la memoria para mostrar. El minidriver rellena este miembro en el controlador para KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS.
cbCaptured
Este miembro especifica el número de bytes copiados en la superficie VRAM. El minidriver establece este valor.
dwWidth
Este miembro especifica el ancho de los datos de vídeo en píxeles. El minidriver establece este valor.
dwHeight
Este miembro especifica el alto de los datos de vídeo, en píxeles. El minidriver establece este valor.
dwLinearSize
Este miembro especifica el tamaño lineal, en bytes, de una superficie norectangular. El minidriver establece este valor.
lPitch
Este miembro especifica el tono de la superficie; es decir, la distancia, en bytes, hasta el inicio de la línea siguiente. Esto también se conoce como el paso de la superficie. El minidriver establece este valor.
ullReserved[16]
El minidriver puede usar este miembro para almacenar información sobre la superficie a medida que controla una solicitud de KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS . Sin embargo, tenga cuidado; esta estructura no persiste en las llamadas avStrMiniPinProcess .
Comentarios
Cuando el minidriver recibe VRAM_SURFACE_INFO a través de una llamada de propiedad KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS , los miembros siguientes a VramPhysicalAddress en la lista de miembros (excepto ullReserved) se reducen a cero. El controlador de captura puede almacenar datos privados relacionados con la captura en estos miembros.
A continuación, AVStream almacena esta información en el encabezado de secuencia y la devuelve al minidriver en la función de devolución de llamada AVStrMiniPinProcess .
Los datos de estos miembros se conservan durante la vigencia del encabezado de secuencia. Cuando se eliminan todos los clones o el borde inicial está avanzado, estos datos ya no son accesibles.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ksmedia.h (incluye Ksmedia.h) |