структура D3DDDICB_LOCK (d3dumddi.h)

  • Статья

Структура D3DDDICB_LOCK описывает параметры для блокировки выделения.

Синтаксис

typedef struct _D3DDDICB_LOCK {
  [in/out] D3DKMT_HANDLE          hAllocation;
  [in]     UINT                   PrivateDriverData;
  [in]     UINT                   NumPages;
  [in]     const UINT             *pPages;
  [out]    VOID                   *pData;
  [in]     D3DDDICB_LOCKFLAGS     Flags;
           D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDICB_LOCK;

Члены

[in/out] hAllocation

Тип данных D3DKMT_HANDLE, представляющий дескриптор в режиме ядра для выделения. Функция pfnAllocateCb среды выполнения Microsoft Direct3D возвращает этот дескриптор. Поэтому драйвер отображения пользовательского режима должен использовать этот дескриптор для блокировки выделения.

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

[in] PrivateDriverData

Частные данные (например, уровень MIP), которые отправляются из драйвера дисплея пользовательского режима в функцию DxgkDdiAcquireSwizzlingRange драйвера минипорта дисплея.

[in] NumPages

Количество страниц в списке страниц, на которые указывает pPages.

[in] pPages

Массив страниц для блокировки. Каждая страница в массиве описывается целочисленным смещением. Ноль означает первую страницу поверхности, вторую и т. д.

[out] pData

Указатель на память, возвращаемую драйвером мини-порта дисплея и диспетчером памяти. При блокировке списка страниц памяти возвращаемый указатель является указателем на первую страницу памяти.

[in] Flags

Структура D3DDDICB_LOCKFLAGS , которая определяет в флагах битовых полей способ блокировки выделения.

Обратите внимание, что совместное указание некоторых флагов недопустимо, а некоторые флаги зависят от других флагов. Дополнительные сведения об указании этих флагов см. в разделе Примечания D3DDDICB_LOCKFLAGS.

GpuVirtualAddress

Этот элемент зарезервирован и должен иметь нулевое значение.

Этот элемент доступен начиная с Windows 7.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть d3dumddi.h (включая D3dumddi.h)

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

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

pfnLockCb