Метод ID3D11DeviceContext1::CopySubresourceRegion1 (d3d11_1.h)

Копирует регион из исходного ресурса в целевой ресурс.

Синтаксис

void CopySubresourceRegion1(
  [in]           ID3D11Resource  *pDstResource,
  [in]           UINT            DstSubresource,
  [in]           UINT            DstX,
  [in]           UINT            DstY,
  [in]           UINT            DstZ,
  [in]           ID3D11Resource  *pSrcResource,
  [in]           UINT            SrcSubresource,
  [in, optional] const D3D11_BOX *pSrcBox,
  [in]           UINT            CopyFlags
);

Параметры

[in] pDstResource

Тип: ID3D11Resource*

Указатель на целевой ресурс.

[in] DstSubresource

Тип: UINT

Индекс целевого подресурса.

[in] DstX

Тип: UINT

Координата X левого верхнего угла области назначения.

[in] DstY

Тип: UINT

Координата Y левого верхнего угла области назначения. Для подресурса 1D это значение должно быть равно нулю.

[in] DstZ

Тип: UINT

Z-координата левого верхнего угла области назначения. Для подресурса 1D или 2D это значение должно быть равно нулю.

[in] pSrcResource

Тип: ID3D11Resource*

Указатель на исходный ресурс.

[in] SrcSubresource

Тип: UINT

Индекс исходного подресурса.

[in, optional] pSrcBox

Тип: const D3D11_BOX*

Указатель на трехмерное поле, определяющее область исходного подресурса, который может копировать CopySubresourceRegion1 . Если значение NULL, CopySubresourceRegion1 копирует весь исходный подресурс. Поле должно помещаться в исходном ресурсе.

Пустое поле приводит к тому, что операция не будет. Поле пусто, если верхнее или равно нижнему значению, или левое значение больше или равно правому значению, или значение переднего края больше или равно обратному значению. Если поле пусто, CopySubresourceRegion1 не выполняет операцию копирования.

[in] CopyFlags

Тип: UINT

D3D11_COPY_FLAGS типизированное значение, указывающее способ выполнения операции копирования. Если вы укажете ноль для параметра без копирования, CopySubresourceRegion1 будет работать так же, как ID3D11DeviceContext::CopySubresourceRegion. Для существующих драйверов отображения, которые не могут обрабатывать эти флаги, среда выполнения не использует их.

Возвращаемое значение

None

Remarks

Если драйвер отображения поддерживает перекрытие, исходный и целевой подресурсы могут быть идентичными, а исходный и конечный регионы могут перекрываться друг с другом. Для существующих драйверов отображения, которые не поддерживают перекрытие, среда выполнения удаляет вызовы с идентичными исходными и целевыми подресурсами независимо от того, перекрываются ли регионы. Чтобы определить, поддерживает ли драйвер отображения перекрытие, проверка элемент CopyWithOverlapD3D11_FEATURE_DATA_D3D11_OPTIONS. Эта перекрываемая поддержка включает дополнительные функции прокрутки при вызове IDXGISwapChain::P resent.

Примечание. Применяется только к оборудованию на уровне компонентов 9_x . При использовании ID3D11DeviceContext1::UpdateSubresource1 или CopySubresourceRegion1 для копирования из промежуточного ресурса в ресурс по умолчанию можно повредить содержимое назначения. Это происходит, если вы передаете поле источника NULL и исходный ресурс имеет измерения, отличные от измерений целевого ресурса, или если используются конечные смещения (x, y и z). В этом случае всегда передайте поле источника, представляющее полный размер исходного ресурса.

 

Требования

Минимальная версия клиента	Windows 8 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	d3d11_1.h
Библиотека	D3D11.lib

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

ID3D11DeviceContext1