структура D3DHAL_D3DEXTENDEDCAPS (d3dhal.h)

D3DHAL_D3DEXTENDEDCAPS описываются дополнительные трехмерные возможности драйвера.

Синтаксис

typedef struct _D3DHAL_D3DEXTENDEDCAPS {
  DWORD    dwSize;
  DWORD    dwMinTextureWidth;
  DWORD    dwMaxTextureWidth;
  DWORD    dwMinTextureHeight;
  DWORD    dwMaxTextureHeight;
  DWORD    dwMinStippleWidth;
  DWORD    dwMaxStippleWidth;
  DWORD    dwMinStippleHeight;
  DWORD    dwMaxStippleHeight;
  DWORD    dwMaxTextureRepeat;
  DWORD    dwMaxTextureAspectRatio;
  DWORD    dwMaxAnisotropy;
  D3DVALUE dvGuardBandLeft;
  D3DVALUE dvGuardBandTop;
  D3DVALUE dvGuardBandRight;
  D3DVALUE dvGuardBandBottom;
  D3DVALUE dvExtentsAdjust;
  DWORD    dwStencilCaps;
  DWORD    dwFVFCaps;
  DWORD    dwTextureOpCaps;
  WORD     wMaxTextureBlendStages;
  WORD     wMaxSimultaneousTextures;
  DWORD    dwMaxActiveLights;
  D3DVALUE dvMaxVertexW;
  WORD     wMaxUserClipPlanes;
  WORD     wMaxVertexBlendMatrices;
  DWORD    dwVertexProcessingCaps;
  DWORD    dwReserved1;
  DWORD    dwReserved2;
  DWORD    dwReserved3;
  DWORD    dwReserved4;
} D3DHAL_D3DEXTENDEDCAPS;

Члены

dwSize

Задает размер этой структуры D3DHAL_D3DEXTENDEDCAPS в байтах.

dwMinTextureWidth

Укажите минимальную ширину текстуры (в пикселях), поддерживаемую драйвером или устройством. Этот элемент обычно имеет значение 2. Эти элементы предоставляются в качестве подсказок для приложения, и оно несет ответственность за настройку размеров текстуры при необходимости.

dwMaxTextureWidth

Укажите максимальную ширину текстуры (в пикселях), поддерживаемую драйвером или устройством. Этот элемент обычно имеет значение 2. Эти элементы предоставляются в качестве подсказок для приложения, и оно несет ответственность за настройку размеров текстуры при необходимости.

dwMinTextureHeight

Укажите минимальную высоту текстуры (в пикселях), поддерживаемую драйвером. Этот элемент обычно имеет значение 2.

dwMaxTextureHeight

Укажите максимальную высоту текстуры (в пикселях), поддерживаемую драйвером. Этот элемент обычно имеет значение 2.

dwMinStippleWidth

Укажите минимальную ширину прогона (в пикселях), поддерживаемую драйвером.

dwMaxStippleWidth

Укажите максимальную ширину прогона (в пикселях), поддерживаемую драйвером.

dwMinStippleHeight

Укажите минимальную высоту скобы (в пикселях), поддерживаемую драйвером.

dwMaxStippleHeight

Укажите максимальную высоту скобы (в пикселях), поддерживаемую драйвером.

dwMaxTextureRepeat

Указывает полный диапазон целочисленных (субфракционных) битов постнормализованных индексов текстуры. Если задан бит D3DDEVCAPS_TEXREPEATNOTSCALEDBYSIZE, то число случаев, когда текстура может быть упакована, указывается этим элементом. Если бит D3DDEVCAPS_TEXREPEATNOTSCALEDBYSIZE не задан, то количество времени, в течение которых текстура может быть упакована, задается выражением dwMaxTextureRepeat * (размер текстуры).

dwMaxTextureAspectRatio

Задает максимальное соотношение сторон текстуры, поддерживаемое оборудованием. Этот элемент обычно имеет значение 2. Это максимальное соотношение сторон предоставляется в виде меры высоты текстуры в пикселях, деляемой на ее ширину в пикселях, или ширину, делимую на высоту, в зависимости от того, какой результат дает больше. Например, текстура шириной 8192 пикселя на 1 пиксель в высоту или 1 пиксель в ширину на 8192 высокое значение недопустима с устройством отображения, которое поддерживает только максимальную пропорцию 4092. Если аппаратное обеспечение не ограничено по пропорциям, dwMaxTextureAspectRatio больше dwMaxTextureWidth и dwMaxTextureHeight.

dwMaxAnisotropy

Задает максимально допустимое значение для состояния отрисовки D3DRENDERSTATE_ANISOTROPY. Если оборудование драйвера не поддерживает анизотропную фильтрацию, драйвер должен установить для этого члена значение 1. Если задать для этого элемента значение 0, это недопустимое значение.

dvGuardBandLeft

dvGuardBandTop

dvGuardBandRight

dvGuardBandBottom

Укажите координаты экранного пространства (в пикселях) области обрезки полосы защиты. Верхний левый угол этого прямоугольника имеет координаты (dvGuardBandLeft, dvGuardBandTop). В левом нижнем углу есть координаты (dvGuardBandRight, dvGuardBandBottom). Координаты внутри этого прямоугольника, но за пределами прямоугольника окна просмотра обрезаются автоматически.

dvExtentsAdjust

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

dwStencilCaps

Указывает операции буфера наборов элементов, поддерживаемые драйвером или устройством. Дополнительные описания операций буфера трафаретов, показанные в следующей таблице, см. в разделе D3DSTENCILOP документации по пакету SDK для DirectX. Предполагается, что операции с набором элементов допустимы для всех трех состояний отрисовки буфера трафарета (D3DRENDERSTATE_STENCILFAIL, D3DRENDERSTATE_STENCILPASS и D3DRENDERSTATE_STENCILZFAIL). Этот элемент может быть побитовой или любого из следующих значений:

dwFVFCaps

Указывает количество координат текстуры, которые может обработать драйвер. Это значение может быть целым числом в диапазоне от 0 до 8, где 0 указывает, что драйвер не поддерживает текстурирование, 1 указывает, что драйвер может обработать только один набор координат текстуры, 2 указывает, что драйвер может обработать два набора координат текстуры и т. д.

Драйвер должен иметь возможность анализировать все координаты текстуры, присутствующих в данных вершины, независимо от количества фактических координат текстуры, которые использует драйвер. Драйвер должен использовать индекс, предоставленный с D3DTSS_TEXCOORDINDEX значением перечисления D3DTEXTURESTAGESTATETYPE, описанным в документации по пакету SDK для DirectX, чтобы определить, какой набор координат текстуры будет использоваться при отрисовке.

dwTextureOpCaps

Указывает операции текстуры, поддерживаемые устройством. Описания операций с текстурами, перечисленных в следующей таблице, см. в D3DTEXTUREOP документации по пакету SDK для DirectX. Этот член может быть побитовой ИЛИ следующих значений:

wMaxTextureBlendStages

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

wMaxSimultaneousTextures

Указывает максимальное количество текстур, которые могут быть одновременно привязаны к этапам наложения текстур для этого устройства. То есть wMaxSimultaneousTextures указывает, сколько этапов текстуры могут иметь текстуры, привязанные к ним с помощью метода lDirect3DDevice7::SetTexture . Дополнительные сведения об этом методе см. в документации по Microsoft Windows SDK.

dwMaxActiveLights

Указывает максимальное количество активных источников света, поддерживаемых этим устройством. Это необходимо указывать только в драйверах, поддерживающих аппаратное преобразование и освещение (и, следовательно, указывать D3DDEVCAPS_HWTRANSFORMANDLIGHT в крышках устройств).

dvMaxVertexW

Указывает максимальный диапазон W, поддерживаемый этим устройством. Это необходимо указать только в драйверах, поддерживающих буферизацию W (и, следовательно, указать D3DPRASTERCAPS_WBUFFER в своих ограничениях растеризации). Единицы измерения для значений глубины W зависят от запущенного приложения. Например, приложение может указывать глубину в метрах.

wMaxUserClipPlanes

Указывает максимальное количество определяемых пользователем плоскостей клипа.

wMaxVertexBlendMatrices

Указывает количество матриц мира, поддерживаемых для смешивания вершин.

dwVertexProcessingCaps

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

dwReserved1

Зарезервировано для системного использования.

dwReserved2

Зарезервировано для системного использования.

dwReserved3

Зарезервировано для системного использования.

dwReserved4

Зарезервировано для системного использования.

Комментарии

Драйвер выделяет и инициализирует эту структуру с нуля и задает соответствующие значения в поддерживаемых элементах. Функция DdGetDriverInfo драйвера возвращает указатель на эту структуру при вызове этой функции с GUID_D3DExtendedCaps GUID.

Когда драйвер заполняет эту структуру, он может задавать значения для возможностей буфера выполнения, даже если интерфейс, используемый для получения возможностей (например , lDirect3DDevice3), не поддерживает буферы выполнения.

Требования

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

DdGetDriverInfo