структура D3DDDIARG_CREATERESOURCE (d3dukmdt.h)

Статья
08/07/2023

Структура D3DDDIARG_CREATERESOURCE содержит сведения о создании ресурса.

Синтаксис

typedef struct _D3DDDIARG_CREATERESOURCE {
  [in]     D3DDDIFORMAT                   Format;
  [in]     D3DDDI_POOL                    Pool;
  [in]     D3DDDIMULTISAMPLE_TYPE         MultisampleType;
  [in]     UINT                           MultisampleQuality;
  [in]     const D3DDDI_SURFACEINFO       *pSurfList;
  [in]     UINT                           SurfCount;
  [in]     UINT                           MipLevels;
  [in]     UINT                           Fvf;
  [in]     D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in]     D3DDDI_RATIONAL                RefreshRate;
  [in/out] HANDLE                         hResource;
  [in]     D3DDDI_RESOURCEFLAGS           Flags;
  [in]     D3DDDI_ROTATION                Rotation;
} D3DDDIARG_CREATERESOURCE;

Члены

[in] Format

D3DDDIFORMAT типизированное значение, указывающее формат ресурсов.

[in] Pool

Значение типа D3DDDI_POOL, указывающее тип пула памяти, из которых создаются ресурсы.

[in] MultisampleType

D3DDDIMULTISAMPLE_TYPE типизированное значение, указывающее количество выборок для поверхности с несколькими выборками. Если поверхность не является несколькими выборкой, это значение равно D3DDDIMULTISAMPLE_NONE (0).

[in] MultisampleQuality

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

Обратите внимание, что даже если поверхность не является множественной выборкой (т. е. если D3DDDIMULTISAMPLE_NONE указана в MultisampleType), она по-прежнему может иметь уровень качества, превышающий 1 (который задается с помощью числа больше 0).

[in] pSurfList

Массив D3DDDI_SURFACEINFO структур для списка поверхностей (или других типов ресурсов) для создания.

[in] SurfCount

Количество ресурсов в массиве, заданное элементом pSurfList .

[in] MipLevels

Количество уровней MIP-карты для ресурсов.

[in] Fvf

Формат FVF для буферов вершин.

[in] VidPnSourceId

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

[in] RefreshRate

Структура D3DDDI_RATIONAL , указывающая частоту обновления, с которым используется ресурс. Этот элемент применим, только если ресурс является основной поверхностью и флаг битового поля MatchGdiPrimary не задан в элементе Flags . Кроме того, если флаг битового поля InterlacedRefresh установлен в разделе Флаги, драйвер отображения пользовательского режима определяет, что частота обновления чередуется (в противном случае — прогрессивно).

[in/out] hResource

Дескриптор ресурса. При входе в функцию CreateResourcehResource указывает дескриптор, который драйвер должен использовать при каждом вызове обратно в среду выполнения Microsoft Direct3D.

Драйвер создает уникальный дескриптор и передает его обратно в среду выполнения Direct3D. В выходных данных функции CreateResourcehResource указывает дескриптор, который среда выполнения Direct3D должна использовать в последующих вызовах драйвера для идентификации ресурса.

[in] Flags

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

[in] Rotation

D3DDDI_ROTATION типизированное значение, определяющее ориентацию ресурса.

Например, учтите, что драйвер дисплея пользовательского режима получает запрос на поворот поверхности 480x640 на 90 градусов (D3DDDI_ROTATION_90). Драйвер должен выделить поверхность в режиме 640x480 для целей сканирования. При отрисовке на поверхность драйвер должен выполнить поворот на 90 градусов.

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

Требования

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

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

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE