Share via

структура VRAM_SURFACE_INFO (ksmedia.h)

  • Статья

Структура VRAM_SURFACE_INFO описывает область системной или отображаемой памяти, в которую мини-driver 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

Указатель на дескриптор режима ядра, который идентифицирует поверхность виртуальной памяти.

VramPhysicalAddress

Этот элемент содержит физический адрес поверхности в памяти дисплея. Мини-отвертка заполняет этот элемент в обработчике для KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS.

cbCaptured

Этот элемент задает количество байтов, скопированных в поверхность виртуальной памяти. Мини-отвертка задает это значение.

dwWidth

Этот элемент задает ширину видеоданных в пикселях. Мини-отвертка задает это значение.

dwHeight

Этот элемент задает высоту видеоданных в пикселях. Мини-отвертка задает это значение.

dwLinearSize

Этот член задает линейный размер нереектаугольной поверхности в байтах. Мини-отвертка задает это значение.

lPitch

Этот элемент задает шаг поверхности; то есть расстояние в байтах до начала следующей строки. Это также называется шаг поверхности. Мини-отвертка задает это значение.

ullReserved[16]

Мини-диск может использовать этот элемент для хранения сведений о поверхности при обработке запроса KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS . Однако соблюдайте осторожность; Эта структура не сохраняется в вызовах AVStrMiniPinProcess .

Комментарии

Когда мини-диск получает VRAM_SURFACE_INFO через вызов свойства KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS , члены, следующие за VramPhysicalAddress в списке элементов (за исключением ullReserved), обнуляются. Драйвер записи может хранить связанные с захватом частные данные в этих членах.

Затем AVStream сохраняет эти сведения в заголовке потока и возвращает их в мини-диск в функции обратного вызова AVStrMiniPinProcess .

Данные в этих членах сохраняются в течение времени существования заголовка потока. Если все клоны удалены или передний край расширен, эти данные больше не доступны.

Требования

Требование Значение
Заголовок ksmedia.h (включая Ksmedia.h)

См. также раздел

AVStrMiniPinProcess

KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS