D3D11DDIARG_CREATERESOURCE結構（d3d10umddi.h）

發行項
02/06/2025

D3D11DDIARG_CREATERESOURCE 結構描述要建立的資源。

語法

typedef struct D3D11DDIARG_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;
  [in]      UINT                                 ByteStride;
  [in]      D3D11_1DDI_VIDEO_DECODER_BUFFER_TYPE DecoderBufferType;
            D3DWDDM2_0DDI_TEXTURE_LAYOUT         TextureLayout;
} D3D11DDIARG_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 開始，如果驅動程式必須建立立體後台緩衝區，它應該將 ArraySize 成員 D3D11DDIARG_CREATERESOURCE 結構的值設定為 2。

[in, pPrimaryDesc

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

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

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

如果 pPrimaryDesc 設定為 NULL，運行時間將會使用中建立的資源;copy-style （bit-block transfer）目前作業。

[in] ByteStride

大小，以位元組為單位，從一個掃描行到表面中的下一個掃描線。

[in] DecoderBufferType

D3D11_DDI_VIDEO_DECODER_BUFFER_TYPE 類型的值，表示視訊譯碼器所使用的緩衝區類型。

如果驅動程式在存取此結構成員之前未檢查D3D11DDI_MINOR_HEADER_VERSION >= 3，則只有在 bindFlags 成員中設定D3D11_DDI_BIND_DECODER旗標時，才應該存取此成員。

TextureLayout