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)

Consulte también

AVStrMiniPinProcess

KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS