D3D10DDIARG_CREATERESOURCE結構（d3d10umddi.h）

發行項
02/06/2025

D3D10DDIARG_CREATERESOURCE 包含 PFND3D10DDI_CREATERESOURCE 用來建立資源的自變數。

語法

typedef struct D3D10DDIARG_CREATERESOURCE {
  [in]      const D3D10DDI_MIPINFO            *pMipInfoList;
  [in]      const D3D10_DDIARG_SUBRESOURCE_UP *pInitialDataUP;
  [in]      D3D10DDIRESOURCE_TYPE             ResourceDimension;
  [in]      UINT                              Usage;
  [in]      UINT                              BindFlags;
  [in]      UINT                              MapFlags;
  [in]      UINT                              MiscFlags;
  [in]      DXGI_FORMAT                       Format;
  [in]      DXGI_SAMPLE_DESC                  SampleDesc;
  [in]      UINT                              MipLevels;
  [in]      UINT                              ArraySize;
  [in, out] DXGI_DDI_PRIMARY_DESC             *pPrimaryDesc;
} D3D10DDIARG_CREATERESOURCE;

成員

[in] pMipInfoList

包含 MIP 層級維度之 D3D10DDI_MIPINFO 結構的數位。對於無法直接使用位元組位址參考單一圖元或紋素的資源格式，實體資源的維度通常大於或等於紋素維度，以滿足必要的空間需求。例如，若要建立完全誤入 BC1 Texture2D，其中最詳細的層級是 8x8， pMipInfoList 数組是： { { 8， 8， 1， 8， 8， 1 }， { 4， 4， 1， 4， 1 }， { 2， 2， 1， 4， 4， 1 }， { 1， 1， 1， 4， 4， 4， 1 } }。

[in] pInitialDataUP

D3D10_DDIARG_SUBRESOURCE_UP 結構的陣列，提供資源子資源清單的初始化資訊。

[in] ResourceDimension

D3D10DDIRESOURCE_TYPE 類型的值，表示資源類型和維度。

[in] Usage

D3D10_DDI_RESOURCE_USAGE 類型的值，指出資源的使用方式。

[in] BindFlags

D3D10_DDI_RESOURCE_BIND_FLAG 值的有效位 OR，表示資源的系結方式。

[in] MapFlags

類型為 D3D10_DDI_MAP 的值，指出要對應至資源的存取層級。

[in] MiscFlags

D3D10_DDI_RESOURCE_MISC_FLAG 值的有效位 OR，表示資源的相關其他資訊。

[in] Format

類型為 DXGI_FORMAT 的值，表示資源的圖元格式。

[in] SampleDesc

DXGI_SAMPLE_DESC 類型的值，描述資源的範例計數和品質。

[in] MipLevels

資源的 MIP 對應層級數目。

[in] ArraySize

2D 紋理或 1D 紋理的陣列元素數目。 ArraySize 必須針對立方體紋理設定為 6。

從 Windows 8 開始，如果驅動程式必須建立立體聲後台緩衝區，它應該將此成員設定為 2 的值。

[in, pPrimaryDesc

描述做為主要資源之 DXGI_DDI_PRIMARY_DESC 結構的指標。

只有在 bindFlags 成員中設定 D3D10_DDI_BIND_PRESENT 位時，Microsoft Direct3D 運行時間才會將 pPrimaryDesc 設為非 NULL 值;不過，即使已設定D3D10_DDI_BIND_PRESENT，運行時間不一定 pPrimaryDesc 設定為非 NULL。將 pPrimaryDesc 設定為非 NULL，表示運行時間會使用已建立的資源作為主要資源（也就是將資源掃描到顯示器），並在翻轉樣式的呈現作業中。

使用者模式顯示驅動程式可以傳回 DriverFlags DXGI_DDI_PRIMARY_DESC 成員中的DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT旗標，以防止運行時間執行翻轉樣式的目前作業。

如果 pPrimaryDesc 設為 NULL，運行時間將會使用複製樣式（位區塊傳輸）中建立的資源。