PFND3D11_1DDI_RESOURCECOPYREGION回呼函式（d3d10umddi.h）

發行項
02/06/2025

將來源子資源區域複製到目的地子資源上的位置。

語法

PFND3D11_1DDI_RESOURCECOPYREGION Pfnd3d111DdiResourcecopyregion;

void Pfnd3d111DdiResourcecopyregion(
       D3D10DDI_HDEVICE unnamedParam1,
       D3D10DDI_HRESOURCE unnamedParam2,
       UINT unnamedParam3,
       UINT unnamedParam4,
       UINT unnamedParam5,
       UINT unnamedParam6,
       D3D10DDI_HRESOURCE unnamedParam7,
       UINT unnamedParam8,
       const D3D10_DDI_BOX *unnamedParam9,
  [in] UINT CopyFlags
)
{...}

參數

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（D3D11_1） 不得執行任何複製作業。

[in] CopyFlags

值，指定複製作業的特性為 D3D11_1_DDI_COPY_FLAGS 列舉型別中值的位 OR。

傳回值

沒有

言論

驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。

Microsoft Direct3D 運行時間會呼叫使用者模式顯示驅動程式的 ResourceCopyRegion（D3D11_1） 函式，以通知驅動程式從指定的來源子資源區域複製到指定目的地子資源上的位置。來源和目的地子資源可以是相同資源的相同子資源。來源和目的地資源都必須是相同的資源類型，而且必須具有可彼此轉換的格式類型（DXGI_FORMAT型別值）。

針對緩衝區，所有座標都必須以位元組為單位;而對於紋理，所有座標都必須以像素為單位。 pSrcBox 參數指向的方塊，不得延伸至來源子資源區域或目的地子資源的邊緣。來源和目的地資源目前不得對應。此外，資源建立旗標會限制資源是否可以參與複製作業。

除了D3DDDIERR_DEVICEREMOVED以外，驅動程式不應該發生任何錯誤。因此，如果驅動程式通過任何錯誤，除了 D3DDDIERR_DEVICEREMOVED 之外，在呼叫 pfnSetErrorCb 函式時，Direct3D 運行時間會判斷錯誤是否重要。即使移除裝置，驅動程式也不需要傳回D3DDDIERR_DEVICEREMOVED;不過，如果裝置移除干擾了的作業（通常不應該發生），驅動程式可以傳回D3DDDIERR_DEVICEREMOVED。

驅動程式可以實作 ResourceCopyRegion（D3D11_1） 函式，此函式可以包含參數語句來處理複製和轉換。也就是說，驅動程式可以實作一個 ResourceCopyRegion（D3D11_1），而且可以將 D3D11_1DDI_DEVICEFUNCS 結構的 pfnResourceConvertRegion 成員設定為指向 ResourceCopyRegion（D3D11_1），以及 D3D11_1DDI_DEVICEFUNCS的 pfnResourceCopyRegion 成員。不過，為了改善效能，驅動程式可以實作個別的 ResourceCopyRegion（D3D11_1） 和 ResourceConvertRegion（D3D11_1） 函式。

下列各節列出複製和轉換的條件：

複製

若要複製，ResourceCopyRegion（D3D11_1） 可確保來源和目的地資源是透過驅動程式的 CreateResource（D3D11）函式建立，並符合下列條件：

目的地資源不是使用 Usage 成員中設定的 D3D10_DDI_USAGE_IMMUTABLE 值所建立 D3D11DDIARG_CREATERESOURCE 結構。
如果來源或目的地資源在 BindFlags 中設定D3D10_DDI_BIND_DEPTH_STENCIL位， D3D10DDIARG_CREATERESOURCE 或為多重取樣資源的成員， ResourceCopyRegion（D3D11_1） 會確認 pSrcBox 參數 NULL，而 DstX、DstY和 DstZ 参数為 0。
子資源索引位於範圍內。
對齊限制適用於座標。
來源和目的地資源不屬於完全相同的子資源。
D3D11DDIARG_CREATERESOURCEFormat 成員中指定的每個來源和目的地資源格式都位於相同的無類型群組中。
來源和目的地資源必須具有相同數量的樣本和品質等級：除了單一取樣的資源，這些資源必須只有相同的樣本數目。

ResourceCopyRegion（D3D11_1） 無法確保目的地位移所位移的來源方塊完全符合資源。 ResourceCopyRegion（D3D11_1） 也不能保證目前沒有對應的子資源。

轉換

若要進行轉換，ResourceCopyRegion（D3D11_1） 可確保來源和目的地資源是透過驅動程式的 CreateResource（D3D11）函式建立，並符合下列條件：

目的地資源不是使用 Usage 成員中設定的 D3D10_DDI_USAGE_IMMUTABLE 值所建立 D3D11DDIARG_CREATERESOURCE 結構。
如果來源或目的地資源在 BindFlagsD3D11DDIARG_CREATERESOURCE 成員中設定D3D10_DDI_BIND_DEPTH_STENCIL位，或為多重取樣資源， ResourceCopyRegion（D3D11_1） 會確認 pSrcBox 參數 NULL，而 DstXDstY，和 DstZ 參數為 0。
子資源索引位於範圍內。
對齊限制適用於座標。
來源和目的地資源不屬於完全相同的子資源。
D3D11DDIARG_CREATERESOURCEFormat 成員中指定的每個來源和目的地資源格式都位於相同的無類型群組中。
D3D11DDIARG_CREATERESOURCEFormat 成員中指定的每個來源和目的地資源格式都支援適當的轉換作業。
來源和目的地資源必須具有相同數量的樣本和品質等級：除了單一取樣的資源，這些資源必須只有相同的樣本數目。

ResourceCopyRegion（D3D11_1） 不會確保目前未對應任何子資源。 ResourceCopyRegion（D3D11_1） 也不會確保目的地位移所位移的來源方塊完全符合資源。

要求

要求	價值
最低支援的用戶端	Windows 8
支援的最低伺服器	Windows Server 2012
目標平臺	桌面
標頭	d3d10umddi.h （包括 D3d10umddi.h）