Метод 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.

Требования

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

ID3D11DeviceContext1