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

  • Статья

Структура D3DDDIARG_LOCKASYNC описывает ресурс или поверхность в ресурсе для блокировки.

Синтаксис

typedef struct _D3DDDIARG_LOCKASYNC {
  [in]  HANDLE                 hResource;
  [in]  UINT                   SubResourceIndex;
  [in]  D3DDDI_LOCKASYNCFLAGS  Flags;
  union {
    [in]  D3DDDIRANGE Range;
    [in]  RECT        Area;
    [in]  D3DDDIBOX   Box;
  };
  [out] HANDLE                 hCookie;
  [out] VOID                   *pSurfData;
  [out] UINT                   Pitch;
  [out] UINT                   SlicePitch;
        D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDIARG_LOCKASYNC;

Члены

[in] hResource

Дескриптор заблокированного ресурса.

[in] SubResourceIndex

Отсчитываемый от нуля индекс ресурса, который указывает hResource . Этот индекс указывает на подресурс или поверхность, которые необходимо заблокировать.

[in] Flags

Структура D3DDDI_LOCKASYNCFLAGS , указывающая в флагах битового поля, как заблокировать ресурс.

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

[in] Range

Структура D3DDDIRANGE, описывающая поддиапсезон линейного ресурса для блокировки, если флаг битового поля RangeValid задан в D3DDDI_LOCKASYNCFLAGS структуре, заданной Flags .

[in] Area

Структура RECT , описывающая подпроект поверхности для блокировки, если флаг битового поля AreaValid установлен в D3DDDI_LOCKASYNCFLAGS структуре, которую указывает Flags .

[in] Box

Структура D3DDDIBOX, описывающая вложенное число тома для блокировки, если флаг битового поля BoxValid установлен в структуре D3DDDI_LOCKASYNCFLAGS, указанной флагом Flags .

[out] hCookie

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

[out] pSurfData

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

[out] Pitch

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

[out] SlicePitch

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

GpuVirtualAddress

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

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

Комментарии

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

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

Требования

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

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

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT