структура 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, определяющее ориентацию общего первичного ресурса.
Если основной ресурс используется с полноэкранным устройством и поворачивается, драйвер может потребоваться для создания промежуточных выделений для обработки полноэкранного устройства. Флаг полноэкранного битового поля установлен в элементе Флаги, чтобы указать, что основной ресурс используется с полноэкранным устройством.
[in] Flags
Структура D3DDDI_OPENRESOURCEFLAGS, которая определяет тип ресурса для открытия.
Замечания
Флаги основного и SharedResource битового поля задаются в элементе флагов структуры D3DDDIARG_CREATERESOURCE в вызове функции CreateResource для создания общего первичного ресурса.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| заголовка | d3dumddi.h (include D3dumddi.h) |