struktur D3D10DDIARG_CREATERESOURCE (d3d10umddi.h)

Artikel
03/08/2023

D3D10DDIARG_CREATERESOURCE berisi argumen yang digunakan oleh PFND3D10DDI_CREATERESOURCE untuk membuat sumber daya.

Sintaks

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;

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 ATAU nilai D3D10_DDI_RESOURCE_BIND_FLAG yang valid 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 D3D10_DDI_RESOURCE_MISC_FLAG yang valid 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.

Mulai Windows 8, jika driver harus membuat buffer back stereo, itu harus mengatur anggota ini 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 DriverFlags DXGI_DDI_PRIMARY_DESC untuk mencegah runtime melakukan operasi menyajikan gaya balik.

Jika pPrimaryDesc diatur ke NULL, runtime akan menggunakan sumber daya yang dibuat dalam operasi penyalinan gaya (transfer blok bit).