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

Статья
02/06/2025

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

Синтаксис

typedef struct _DXGKARGCB_ALLOCATECONTIGUOUSMEMORY {
  [in]  SIZE_T                   NumberOfBytes;
  [in]  PHYSICAL_ADDRESS         LowestAcceptableAddress;
  [in]  PHYSICAL_ADDRESS         HighestAcceptableAddress;
  [in]  PHYSICAL_ADDRESS         BoundaryAddressMultiple;
  [in]  DXGK_MEMORY_CACHING_TYPE CacheType;
  [out] HANDLE                   hMemoryHandle;
  [out] PVOID                    pMemory;
} DXGKARGCB_ALLOCATECONTIGUOUSMEMORY;

Члены

[in] NumberOfBytes

Размер в байтах блока выделенной непрерывной памяти.

[in] LowestAcceptableAddress

Самый низкий допустимый физический адрес вызывающего объекта. Например, если устройство может обращаться только к расположениям, превышающим первые 8 мегабайта диапазона адресов физической памяти процессора, драйвер для этого устройства должен задать значение "НизкийAcceptableAddress" для 0x0000000000800000.

[in] HighestAcceptableAddress

Самый высокий допустимый физический адрес вызывающего объекта. Например, если устройство может обращаться только к расположениям в первых 16 мегабайтах диапазона адресов физической памяти процессора, драйвер для этого устройства должен задать значение HighestAcceptableAddress для 0x0000000000FFFFFF.

[in] BoundaryAddressMultiple

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

[in] CacheType

Значение DXGK_MEMORY_CACHING_TYPE, указывающее тип кэша выделенных страниц.

[out] hMemoryHandle

Дескриптор отслеживания Dxgkrnl для выделения. Это значение должно быть передано соответствующей функции обратного вызова DGXKCB_FREECONTIGUOUSMEMORY.

[out] pMemory

Непрерывная часть нестраничной физической памяти гарантированно сопоставляется с IOMMU в течение своего существования.

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1803 (WDDM 2.4)
заголовка	d3dkmddi.h

См. также

DXGKCB_ALLOCATECONTIGUOUSMEMORY

Поделиться через