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

Статья
02/06/2025

Структура 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)

См. также

D3DDDI_LOCKFLAGS

блокировки

Поделиться через