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

Указатель на область памяти для заблокированного ресурса. Функция Lock драйвера отображения пользовательского режима возвращает этот указатель на среду выполнения Microsoft Direct3D.

[out] Pitch

Шаг в байтах поверхности, которая была заблокирована. Функция Lock драйвера отображения пользовательского режима возвращает это значение тона в среду выполнения Direct3D.

[out] SlicePitch

Шаг среза в байтах заблокированной поверхности. Функция Lock драйвера отображения пользовательского режима возвращает это значение тона среза в среду выполнения Direct3D.

[in] Flags

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

Комментарии

Члены структуры, указанной элементом Flags , должны соответствовать следующим правилам:

• Флаги битовых полей ReadOnly и WriteOnly не должны устанавливаться одновременно.
• Флаг битового поля NoOverwrite не должен устанавливаться одновременно с флагом Отменить битовое поле.
• В любое время должен быть установлен только один из флагов битового поля RangeValid, AreaValid и BoxValid .
• Флаг битового поля ReadOnly не должен устанавливаться одновременно с флагом отменить битовое поле.

Требования

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

D3DDDI_LOCKFLAGS

Блокировка