PFND3D10DDI_RESOURCECOPYREGION回呼函式 （d3d10umddi.h）
ResourceCopyRegion 函式會將來源子資源區域複製到目的地子資源上的位置。
語法
PFND3D10DDI_RESOURCECOPYREGION Pfnd3d10ddiResourcecopyregion;
void Pfnd3d10ddiResourcecopyregion(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HRESOURCE unnamedParam2,
UINT unnamedParam3,
UINT unnamedParam4,
UINT unnamedParam5,
UINT unnamedParam6,
D3D10DDI_HRESOURCE unnamedParam7,
UINT unnamedParam8,
const D3D10_DDI_BOX *unnamedParam9
)
{...}
參數
unnamedParam1
hDevice [in]
顯示裝置的句柄（圖形內容）。
unnamedParam2
hDstResource [in]
要複製到目的地資源的句柄。
unnamedParam3
DstSubresource [in]
索引，表示要複製的目標子資源。
unnamedParam4
DstX [in]
目的地子資源的 X 座標。
unnamedParam5
DstY [in]
目的地子資源的 Y 座標。 對於一維 （1D） 子資源，DstY 會設定為零。
unnamedParam6
DstZ [in]
目的地子資源的 z 座標。 對於一維 （1D） 和二維 （2D） 子資源，DstZ 設為零。
unnamedParam7
hSrcResource [in]
要從中複製的來源資源句柄。
unnamedParam8
SrcSubresource [in]
索引，表示要從中複製的來源子資源。
unnamedParam9
pSrcBox [in， optional]
D3D10_DDI_BOX 結構的指標，指定符合來源或目的地子資源的方塊。 如果 pSrcBoxNULL，驅動程式應該將整個來源子資源複製到目的地。
如果 D3D10_DDI_BOX 結構的成員 左>=右、頂端>=下，或 前>=，則 pSrcBox 會視為空白， 和 ResourceCopyRegion 不得執行任何複製作業。
傳回值
沒有
言論
驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。
Microsoft Direct3D 運行時間會呼叫使用者模式顯示驅動程式的 ResourceCopyRegion 函式，以通知驅動程式從指定的來源子資源區域複製到指定目的地子資源上的位置。 來源和目的地子資源不能是相同資源的相同子資源。 來源和目的地資源都必須是相同的資源類型，而且必須具有可彼此轉換的格式類型（DXGI_FORMAT型別值）。
針對緩衝區，所有座標都必須以位元組為單位;而對於紋理，所有座標都必須以像素為單位。 pSrcBox 參數指向的方塊，不得延伸至來源子資源區域或目的地子資源的邊緣。 來源和目的地資源目前不得對應。 此外，資源建立旗標會限制資源是否可以參與複製作業。
除了D3DDDIERR_DEVICEREMOVED以外，驅動程式不應該發生任何錯誤。 因此，如果驅動程式通過任何錯誤，除了 D3DDDIERR_DEVICEREMOVED 之外，在呼叫 pfnSetErrorCb 函式時，Direct3D 運行時間會判斷錯誤是否重要。 即使移除裝置，驅動程式也不需要傳回D3DDDIERR_DEVICEREMOVED;不過，如果裝置移除干擾了 ResourceCopyRegion 的作業（通常不應該發生），驅動程式可以傳回D3DDDIERR_DEVICEREMOVED。
Direct3D 10.1 版的 ResourceCopyRegion 與 Direct3D 10.0 版本在呼叫驅動程式 CreateResource（D3D10） 函式時所建立之來源和目的地資源的 D3D10DDIARG_CREATERESOURCE 成員，具有與 Direct3D 10.0 版本的主要功能差異。 針對 ResourceCopyRegion的 Direct3D 10.0 版本，來源和目的地資源的 resourceDimension D3D10DDIARG_CREATERESOURCE 成員必須相符。 Direct3D 10.1 版的 ResourceCopyRegion 可讓您稍微放寬來源和目的地資源的 D3D10DDIARG_CREATERESOURCE ResourceDimension 成員。 Direct3D 10.1 版的 ResourceCopyRegion 可讓您在 TexCube 目的地資源上複製 Tex2D 來源資源，或在 Tex2D 目的地資源上複製 TexCube 來源資源。 此外，在資源層級的 TexCube 差異在 Direct3D 10.1 版中已消失。 Direct3D 10.1 版的 ResourceCopyRegion 只代表是否可以複製 TexCube。 在 Direct3D 10.0 版中，複製資源、驗證多個轉譯目標等等（也就是說，需要資源類型完全相同的各種作業）都包含了 TexCube 以納入資源類型的區別。 在 Direct3D 10.1 版中，運行時間只能判斷 Tex2D。
下列各節列出複製和轉換的條件：
複製
若要複製，ResourceCopyRegion 可確保來源和目的地資源是透過驅動程式的 CreateResource（D3D10） 函式建立，並符合下列條件：
- 目的地資源不是使用在 D3D10DDIARG_CREATERESOURCE 結構 Usage 成員中設定的D3D10_DDI_USAGE_IMMUTABLE值所建立。
- 如果來源或目的地資源在 BindFlags 中設定D3D10_DDI_BIND_DEPTH_STENCIL位 D3D10DDIARG_CREATERESOURCE 成員，或為多重取樣資源， ResourceCopyRegion 會確認 pSrcBox 參數 NULL，而 DstX、DstY和 DstZ 參數為 0。
- 子資源索引位於範圍內。
- 對齊限制適用於座標。
- 來源和目的地資源不屬於完全相同的子資源。
- D3D10DDIARG_CREATERESOURCE的 Format 成員中指定的每個來源和目的地資源格式都位於相同的無類型群組中。
- 來源和目的地資源必須具有相同數量的樣本和品質等級：除了單一取樣的資源，這些資源必須只有相同的樣本數目。
轉換
若要進行轉換，ResourceCopyRegion 可確保來源和目的地資源是透過驅動程式的 CreateResource（D3D10） 函式建立，並符合下列條件：
- 目的地資源不是使用在 D3D10DDIARG_CREATERESOURCE 結構 Usage 成員中設定的D3D10_DDI_USAGE_IMMUTABLE值所建立。
- 如果來源或目的地資源在 BindFlags 中設定D3D10_DDI_BIND_DEPTH_STENCIL位 D3D10DDIARG_CREATERESOURCE 成員，或為多重取樣資源， ResourceCopyRegion 會確認 pSrcBox 參數 NULL，而 DstX、DstY和 DstZ 參數為 0。
- 子資源索引位於範圍內。
- 對齊限制適用於座標。
- 來源和目的地資源不屬於完全相同的子資源。
- D3D10DDIARG_CREATERESOURCE的 Format 成員中指定的每個來源和目的地資源格式都位於相同的無類型群組中。
- D3D10DDIARG_CREATERESOURCE Format 成員中指定的每個來源和目的地資源格式都支援適當的轉換作業。
- 來源和目的地資源必須具有相同數量的樣本和品質等級：除了單一取樣的資源，這些資源必須只有相同的樣本數目。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
| 目標平臺 | 桌面 |
| 標頭 | d3d10umddi.h （包括 D3d10umddi.h） |