структура 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
Указатель на дескриптор режима ядра, определяющий поверхность VRAM.
VramPhysicalAddress
Этот элемент содержит физический адрес поверхности в памяти отображения. Мини-driver заполняет этот элемент обработчиком для KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS.
cbCaptured
Этот элемент указывает количество байтов, скопированных в область VRAM. Мини-driver задает это значение.
dwWidth
Этот элемент задает ширину видеоданных в пикселях. Мини-driver задает это значение.
dwHeight
Этот элемент задает высоту видеоданных в пикселях. Мини-driver задает это значение.
dwLinearSize
Этот элемент задает линейный размер в байтах несектулярной поверхности. Мини-driver задает это значение.
lPitch
Этот элемент задает шаг поверхности; то есть расстояние в байтах до начала следующей строки. Это также известно как шаг поверхности. Мини-driver задает это значение.
ullReserved[16]
Мини-driver может использовать этот элемент для хранения сведений о поверхности, так как он обрабатывает запрос KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS. Используйте осторожность, однако; Эта структура не сохраняется в вызовах AVStrMiniPinProcess.
Замечания
Когда мини-driver получает VRAM_SURFACE_INFO через вызов свойства KSPROPERTY_MAP_CAPTURE_HANDLE_TO_VRAM_ADDRESS, члены, следующие VramPhysicalAddress в списке членов (за исключением ullReserved) отсчитываются от нуля. Драйвер записи может хранить частные данные, связанные с записью, в этих членах.
Затем AVStream сохраняет эти сведения в заголовке потока и возвращает его в мини-driver в функции обратного вызова AVStrMiniPinProcess.
Данные в этих элементах сохраняются в течение всего времени существования заголовка потока. Если все клоны удаляются или передний край расширен, эти данные больше не доступны.
Требования
| Требование | Ценность |
|---|---|
| заголовка | ksmedia.h (include Ksmedia.h) |