struktur D3DDDIARG_CREATERESOURCE (d3dukmdt.h)

Artikel
02/23/2024

Struktur D3DDDIARG_CREATERESOURCE berisi informasi untuk membuat sumber daya.

Sintaks

typedef struct _D3DDDIARG_CREATERESOURCE {
  [in]     D3DDDIFORMAT                   Format;
  [in]     D3DDDI_POOL                    Pool;
  [in]     D3DDDIMULTISAMPLE_TYPE         MultisampleType;
  [in]     UINT                           MultisampleQuality;
  [in]     const D3DDDI_SURFACEINFO       *pSurfList;
  [in]     UINT                           SurfCount;
  [in]     UINT                           MipLevels;
  [in]     UINT                           Fvf;
  [in]     D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in]     D3DDDI_RATIONAL                RefreshRate;
  [in/out] HANDLE                         hResource;
  [in]     D3DDDI_RESOURCEFLAGS           Flags;
  [in]     D3DDDI_ROTATION                Rotation;
} D3DDDIARG_CREATERESOURCE;

Anggota

[in] Format

Nilai jenis D3DDDIFORMAT yang menunjukkan format sumber daya.

[in] Pool

Nilai jenis D3DDDI_POOL yang menunjukkan jenis kumpulan memori tempat sumber daya dibuat.

[in] MultisampleType

Nilai jenis D3DDDIMULTISAMPLE_TYPE yang menunjukkan jumlah sampel untuk permukaan beberapa sampel. Jika permukaan tidak beberapa sampel, nilai ini D3DDDIMULTISAMPLE_NONE (0).

[in] MultisampleQuality

Tingkat kualitas sampel penyajian di permukaan beberapa sampel. Tingkat kualitas harus berupa angka dari 0 hingga 7 yang mewakili tingkat kualitas masing-masing dari 1 hingga 8.

Perhatikan bahwa bahkan jika permukaan tidak diambil sampelnya ganda (yaitu, jika D3DDDIMULTISAMPLE_NONE ditentukan dalam MultisampleType), permukaan masih dapat memiliki tingkat kualitas yang lebih besar dari 1 (yang ditentukan dengan menggunakan angka yang lebih besar dari 0).

[in] pSurfList

Array struktur D3DDDI_SURFACEINFO untuk daftar permukaan (atau jenis sumber daya lainnya) untuk dibuat.

[in] SurfCount

Jumlah sumber daya dalam array yang ditentukan oleh anggota pSurfList .

[in] MipLevels

Jumlah tingkat peta MIP untuk sumber daya.

[in] Fvf

Format FVF untuk buffer vertex.

[in] VidPnSourceId

Nomor identifikasi berbasis nol dari sumber video yang ada di jalur topologi video present network (VidPN) tempat permukaan utama dibuat (jika sumber daya berisi permukaan utama).

[in] RefreshRate

Struktur D3DDDI_RATIONAL yang menentukan laju refresh yang digunakan sumber daya. Anggota ini hanya berlaku jika sumber daya adalah permukaan utama dan bendera bit-field MatchGdiPrimary tidak diatur dalam anggota Bendera . Selain itu, jika bendera bit-field InterlacedRefresh diatur dalam Bendera, driver tampilan mode pengguna menentukan bahwa laju refresh diselingi (jika tidak, progresif).

[in/out] hResource

Handel ke sumber daya. Pada input ke fungsi CreateResource , hResource menentukan handel yang harus digunakan driver kapan saja memanggil kembali ke runtime Microsoft Direct3D.

Driver menghasilkan handel unik dan meneruskannya kembali ke runtime Direct3D. Pada output dari fungsi CreateResource , hResource menentukan handel yang harus digunakan runtime Direct3D dalam panggilan driver berikutnya untuk mengidentifikasi sumber daya.

[in] Flags

Struktur D3DDDI_RESOURCEFLAGS yang mengidentifikasi jenis sumber daya yang akan dibuat. Perhatikan bahwa beberapa bendera bit-field di D3DDDI_RESOURCEFLAGS mengharuskan bendera bidang bit tambahan juga diatur.

[in] Rotation

Nilai jenis D3DDDI_ROTATION yang mengidentifikasi orientasi sumber daya.

Misalnya, pertimbangkan bahwa driver tampilan mode pengguna menerima permintaan permukaan 480x640 untuk diputar 90 derajat (D3DDDI_ROTATION_90). Driver harus mengalokasikan permukaan dalam mode 640x480 untuk tujuan pemindaian. Saat merender ke permukaan, driver harus melakukan rotasi 90 derajat.

Orientasi selain D3DDDI_ROTATION_IDENTITY diatur hanya ketika bendera bit-field Utama juga diatur dalam anggota Bendera .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	d3dukmdt.h (termasuk D3dumddi.h, D3dkmddi.h)

Lihat juga

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE