struktur D3D11DDIARG_CREATERESOURCE (d3d10umddi.h)

Artikel
02/26/2024

Struktur D3D11DDIARG_CREATERESOURCE menjelaskan sumber daya yang akan dibuat.

Sintaks

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;

Anggota

[in] pMipInfoList

Array struktur D3D10DDI_MIPINFO yang berisi dimensi untuk tingkat MIP. Untuk format sumber daya di mana satu piksel atau texel tidak dapat direferensikan langsung dengan alamat byte, dimensi sumber daya fisik biasanya lebih besar atau sama dengan dimensi texel, untuk memenuhi persyaratan ruang yang diperlukan. Misalnya, untuk membuat BC1 Texture2D yang sepenuhnya dimigrasikan, dengan tingkat yang paling detail adalah 8x8, array pMipInfoList adalah: { 8, 8, 1, 8, 8, 1 }, { 4, 4, 1, 4, 4, 1 }, { 2, 2, 1, 4, 4, 1 }, { 1, 1, 1, 4, 4, 1 } .

[in] pInitialDataUP

Array struktur D3D10_DDIARG_SUBRESOURCE_UP yang menyediakan informasi inisialisasi untuk daftar subsumber daya.

[in] ResourceDimension

Nilai jenis D3D10DDIRESOURCE_TYPE yang menunjukkan jenis dan dimensi sumber daya.

[in] Usage

Nilai jenis D3D10_DDI_RESOURCE_USAGE yang menunjukkan bagaimana sumber daya digunakan.

[in] BindFlags

Bitwise YANG valid ATAU nilai jenis D3D10_DDI_RESOURCE_BIND_FLAG yang menunjukkan bagaimana sumber daya terikat.

[in] MapFlags

Nilai jenis D3D10_DDI_MAP yang menunjukkan tingkat akses untuk memetakan ke sumber daya.

[in] MiscFlags

Bitwise ATAU nilai jenis D3D10_DDI_RESOURCE_MISC_FLAG yang menunjukkan informasi lain-lain tentang sumber daya.

[in] Format

Nilai jenis DXGI_FORMAT yang menunjukkan format piksel sumber daya.

[in] SampleDesc

Nilai jenis DXGI_SAMPLE_DESC yang menjelaskan jumlah sampel dan kualitas sumber daya.

[in] MipLevels

Jumlah tingkat peta MIP untuk sumber daya.

[in] ArraySize

Jumlah elemen array untuk tekstur 2-D atau tekstur 1-D. ArraySize harus diatur ke 6 untuk tekstur kubus.

Dimulai di Windows 8, jika driver harus membuat buffer back stereo, itu harus mengatur anggota ArraySize dari struktur D3D11DDIARG_CREATERESOURCE ke nilai 2.

[in, pPrimaryDesc

Penunjuk ke struktur DXGI_DDI_PRIMARY_DESC yang menjelaskan sumber daya yang digunakan sebagai primer.

Runtime Microsoft Direct3D mengatur pPrimaryDesc ke nilai non-NULL hanya jika bit D3D10_DDI_BIND_PRESENT diatur dalam anggota BindFlags ; namun, bahkan jika D3D10_DDI_BIND_PRESENT diatur, runtime tidak selalu mengatur pPrimaryDesc ke non-NULL. Mengatur pPrimaryDesc ke non-NULL menunjukkan bahwa runtime akan menggunakan sumber daya yang dibuat sebagai primer (yaitu, sumber daya dipindai ke tampilan) dan dalam operasi menyajikan gaya balik.

Driver tampilan mode pengguna dapat mengembalikan bendera DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT di anggota DXGI_DDI_PRIMARY_DESC DriverFlagsuntuk mencegah runtime melakukan operasi menyajikan gaya balik.

Jika pPrimaryDesc diatur ke NULL, runtime akan menggunakan sumber daya yang dibuat di; copy-style (transfer bit-block) menyajikan operasi.

[in] ByteStride

Ukuran, dalam byte, dari satu baris pemindaian ke garis pemindaian berikutnya di permukaan.

[in] DecoderBufferType

Nilai jenis D3D11_DDI_VIDEO_DECODER_BUFFER_TYPE yang menunjukkan jenis buffer yang digunakan oleh dekoder video.

Jika driver tidak memeriksa apakah D3D11DDI_MINOR_HEADER_VERSION >= 3 sebelum mengakses anggota struktur ini, driver harus mengakses anggota ini hanya ketika bendera D3D11_DDI_BIND_DECODER diatur dalam anggota BindFlags .

TextureLayout