структура D3DDDIARG_LOCK (d3dumddi.h)
Структура D3DDDIARG_LOCK описывает ресурс или поверхность в ресурсе для блокировки.
Синтаксис
typedef struct _D3DDDIARG_LOCK {
[in] HANDLE hResource;
[in] UINT SubResourceIndex;
union {
[in] D3DDDIRANGE Range;
[in] RECT Area;
[in] D3DDDIBOX Box;
};
[out] VOID *pSurfData;
[out] UINT Pitch;
[out] UINT SlicePitch;
[in] D3DDDI_LOCKFLAGS Flags;
} D3DDDIARG_LOCK;
Члены
[in] hResource
Дескриптор ресурса, который необходимо заблокировать.
[in] SubResourceIndex
Отсчитываемый от нуля индекс ресурса, который указывается дескриптором, заданным hResource. Этот индекс указывает на блокировку подресурса или поверхности.
[in] Range
Структура D3DDDIRANGE, описывающая подчинение линейного ресурса для блокировки.
[in] Area
Структура RECT, описывающая подрезку поверхности для блокировки.
[in] Box
Структура D3DDDIBOX, описывающая подволок тома для блокировки.
[out] pSurfData
Указатель на область памяти для заблокированного ресурса. Функция блокировки блокировки в пользовательском режиме возвращает этот указатель на среду выполнения Microsoft Direct3D.
[out] Pitch
Поле в байтах поверхности, которая была заблокирована. Функция блокировки драйвера в пользовательском режиме возвращает это значение шага в среду выполнения Direct3D.
[out] SlicePitch
Шаг среза в байтах поверхности, заблокированной. Функция блокировки драйвера в пользовательском режиме возвращает значение шага среза в среду выполнения Direct3D.
[in] Flags
Структура D3DDDI_LOCKFLAGS, указывающая на блокировку ресурса в битовых флагах поля. Обратите внимание, что некоторые флаги являются взаимоисключающими с другими флагами. Дополнительные сведения см. в следующем разделе "Примечания".
Замечания
Члены структуры, указанной элементом флагов , должны соответствовать следующим правилам:
- Флаги ReadOnly и WriteOnly флаги битового поля не должны быть установлены одновременно.
- Флаг NoOverwrite битового поля не должен быть одновременно задан с флагом Отмена битового поля.
- Только один из RangeValid, AreaValidи BoxValid флаги битового поля должны быть установлены в любое время.
- Флаг ReadOnly битового поля не должен быть одновременно задан с флагом Отмена битового поля.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
заголовка | d3dumddi.h (include D3dumddi.h) |