VRAM_SURFACE_INFO结构 (ksmedia.h)

VRAM_SURFACE_INFO结构描述 AVStream 微型驱动程序捕获音频或视频数据的系统或显示内存区域。

语法

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;

成员

hSurface

指向标识 VRAM 图面的内核模式句柄的指针。

VramPhysicalAddress

此成员包含显示内存中图面的物理地址。 微型驱动程序在处理程序中填充 KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS的此成员。

cbCaptured

此成员指定复制到 VRAM 图面中的字节数。 微型驱动程序设置此值。

dwWidth

此成员指定视频数据的宽度(以像素为单位)。 微型驱动程序设置此值。

dwHeight

此成员指定视频数据的高度(以像素为单位)。 微型驱动程序设置此值。

dwLinearSize

此成员指定非矩形图面的线性大小(以字节为单位)。 微型驱动程序设置此值。

lPitch

此成员指定图面的间距;即,到下一行开头的距离(以字节为单位)。 这也称为表面 步幅。 微型驱动程序设置此值。

ullReserved[16]

微型驱动程序可以使用此成员在处理 KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS 请求时存储有关图面的信息。 但是,请谨慎使用;此结构不会在 AVStrMiniPinProcess 调用中持久保存。

言论

当微型驱动程序通过 KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS 属性调用接收VRAM_SURFACE_INFO时,成员列表中 VramPhysicalAddress(除 ullReserved除外)的成员将被归零。捕获驱动程序可以在这些成员中存储与捕获相关的私有数据。

AVStream 然后将此信息存储在流标头中,并将其返回到 AVStrMiniPinProcess 回调函数中的微型驱动程序。

这些成员中的数据在流标头的生存期内保留。 删除所有克隆或前导边缘处于高级时,将不再可访问此数据。

要求

要求 价值
标头 ksmedia.h (包括 Ksmedia.h)

另请参阅

AVStrMiniPinProcess

KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS