структура DXGKARGCB_MAPFRAMEBUFFERPOINTER (d3dkmddi.h)

  • Статья

Структура DXGKARGCB_MAPFRAMEBUFFERPOINTER содержит аргументы, используемые функцией обратного вызова DXGKCB_MAPFRAMEBUFFERPOINTER для сопоставления указателя буфера кадров.

Синтаксис

typedef struct _DXGKARGCB_MAPFRAMEBUFFERPOINTER {
  [in]     UINT   PhysicalAdapterIndex;
  [in]     SIZE_T Size;
  [in/out] SIZE_T Offset;
  [out]    PVOID  pBaseAddress;
} DXGKARGCB_MAPFRAMEBUFFERPOINTER;

Члены

[in] PhysicalAdapterIndex

Индекс физического адаптера.

[in] Size

Размер сопоставленной подобласти объекта section (в байтах). Размер должен быть кратным PAGE_SIZE.

[in/out] Offset

Во входных данных это смещение в байтах к сопоставленной подобласти объекта section. Смещение должно быть кратно PAGE_SIZE. В выходных данных это смещение от выходного базового адреса, на который драйвер должен скопировать данные.

[out] pBaseAddress

Доступный ЦП базовый адрес, указатель на сопоставленную подобласть объекта section. Драйвер должен добавить выходное значение Offset в базовый адрес, чтобы получить адрес назначения для всех операций копирования (pDestinationAddress = pBaseAddress + Offset).

Комментарии

Если не удается закрепить весь объект секции буфера кадров, драйвер должен попытаться обеспечить прогресс вперед, выполняя передачу в небольших фрагментах. Это достигается путем выделения небольшого MDL или фрагмента памяти во время инициализации, который можно использовать для передачи содержимого с оборудования, а затем вызова DXGKCB_MAPFRAMEBUFFERPOINTER для получения указателя на подобласть объекта section.

Драйвер отвечает за копирование данных из предварительно выделенного буфера в сопоставленный регион. Обратное также верно при восстановлении содержимого буфера кадров.

Дополнительные сведения см. в разделе Изоляция GPU на основе IOMMU .

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1803 (WDDM 2.4)
Верхняя часть d3dkmddi.h

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

DXGKCB_MAPFRAMEBUFFERPOINTER