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

  • Статья

Структура D3DDDIARG_OPENRESOURCE содержит сведения об открытии общего ресурса.

Синтаксис

typedef struct _D3DDDIARG_OPENRESOURCE {
  [in]     UINT                      NumAllocations;
  union {
    [in]     D3DDDI_OPENALLOCATIONINFO  *pOpenAllocationInfo;
             D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  };
  [in]     D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
  [in]     D3DKMT_HANDLE             hKMResource;
  [in]     VOID                      *pPrivateDriverData;
  [in]     UINT                      PrivateDriverDataSize;
  [in/out] HANDLE                    hResource;
  [in]     D3DDDI_ROTATION           Rotation;
  [in]     D3DDDI_OPENRESOURCEFLAGS  Flags;
} D3DDDIARG_OPENRESOURCE;

Члены

[in] NumAllocations

Количество элементов в массиве, заданное pOpenAllocationInfo. NumAllocations представляет количество открытых выделений.

[in] pOpenAllocationInfo

Массив D3DDDI_OPENALLOCATIONINFO структур, описывающих выделения в открываемом ресурсе.

[in] Массив D3DDDI_OPENALLOCATIONINFO структур, описывающих выделения в открываемом ресурсе.

pOpenAllocationInfo2

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

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

[in] hKMResource

Тип данных D3DKMT_HANDLE, представляющий дескриптор режима ядра для ресурса, связанного с выделениями.

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

[in] pPrivateDriverData

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

[in] PrivateDriverDataSize

Размер (в байтах) частных данных, на которые указывает pPrivateDriverData.

[in/out] hResource

Дескриптор ресурса, связанного с выделениями.

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

[in] Rotation

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

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

[in] Flags

Структура D3DDDI_OPENRESOURCEFLAGS , определяющая тип открываемого ресурса.

Комментарии

Флаги битовых полей Primary и SharedResource задаются в элементе Flags структуры D3DDDIARG_CREATERESOURCE при вызове функции CreateResource для создания общего первичного ресурса.

Требования

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

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

CreateResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OPENALLOCATIONINFO

D3DDDI_OPENRESOURCEFLAGS

D3DDDI_ROTATION

OpenResource