共用方式為


PFND3D11DDI_COPYSTRUCTURECOUNT回呼函式 (d3d10umddi.h)

CopyStructureCount 函式會將附加緩衝區未排序存取檢視 (UAV) 的填滿部分項目數目複製到目的地緩衝區的位移。

語法

PFND3D11DDI_COPYSTRUCTURECOUNT Pfnd3d11ddiCopystructurecount;

void Pfnd3d11ddiCopystructurecount(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HRESOURCE unnamedParam2,
  UINT unnamedParam3,
  D3D11DDI_HUNORDEREDACCESSVIEW unnamedParam4
)
{...}

參數

unnamedParam1

hDevice [in]

顯示裝置的句柄(圖形內容)。

unnamedParam2

hDstBuffer [in]

目的地緩衝區的句柄,用來複製 UAV 的填滿大小值。 若要建立此目的地緩衝區,運行時間先前必須呼叫驅動程式的 CreateResource(D3D11) 函式 函式,且 ResourceDimensionD3D11DDIARG_CREATERESOURCE 結構的成員設定為 D3D10DDIRESOURCE_BUFFER 值。

unnamedParam3

DstAlignedByteOffset [in]

hDstBuffer 參數所指定的目的地緩衝區中,以位元組為單位的 4 位元組對齊位移。 CopyStructureCount 會複製附加緩衝區檢視的填滿大小值,hSrcView 參數在 hDstBuffer 中指定此位移。 DstAlignedByteOffset 必須是四個的倍數。

unnamedParam4

hSrcView [in]

來源附加 UAV 的句柄,必須是附加緩衝區檢視。 CopyStructureCount 會將這個檢視的填滿大小值複製到 hDstBuffer 參數指定的目的地緩衝區。 若要建立這個附加緩衝區檢視,運行時間之前必須呼叫驅動程式的 CreateUnorderedAccessView 函式,且已設定D3D11_DDI_BUFFER_UAV_FLAG_APPEND旗標。

傳回值

沒有

言論

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

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

CopyStructureCount 接受附加緩衝區 UAV 的填滿大小值(支援在堆棧上等結構上推送和快顯作業的 UAV),並將此值複製到目的地緩衝區的位移。 圖形硬體會使用 4 位元組填滿大小值來追蹤附加緩衝區 UAV 中填入的數據量。

要求

要求 價值
最低支援的用戶端 從 Windows 7作系統開始,支援 CopyStructureCount。
目標平臺 桌面
標頭 d3d10umddi.h (包括 D3d10umddi.h)

另請參閱

CreateResource(D3D11)

CreateUnorderedAccessView

D3D11DDI_DEVICEFUNCS

pfnSetErrorCb