Metode IDXCoreAdapter::GetProperty

Mengambil nilai properti adaptor yang ditentukan. Sebelum memanggil GetProperty untuk jenis properti, panggil IsPropertySupported untuk mengonfirmasi bahwa jenis properti tersedia untuk adaptor dan sistem operasi (OS) ini. Juga sebelum memanggil GetProperty, panggil GetPropertySize untuk menentukan ukuran buffer yang diperlukan untuk menerima nilai properti.

Sintaks

virtual HRESULT STDMETHODCALLTYPE GetProperty(
  DXCoreAdapterProperty property,
  size_t bufferSize,
  _Out_writes_bytes_(bufferSize) void *propertyData) = 0;

template <class T>
HRESULT GetProperty( 
  DXCoreAdapterProperty property,
  _Out_writes_bytes_(sizeof(T)) T *propertyData);

Parameter

properti

Jenis: DXCoreAdapterProperty

Jenis properti yang nilainya ingin Anda ambil. Lihat tabel di DXCoreAdapterProperty untuk informasi selengkapnya tentang setiap properti adaptor.

bufferSize

Jenis: size_t

Ukuran, dalam byte, dari buffer output yang Anda alokasikan dan sediakan di propertyData.

propertyData [out]

Jenis: batal*

Penunjuk ke buffer output yang Anda alokasikan dalam aplikasi Anda, dan fungsi tersebut terisi. Panggil GetPropertySize untuk menentukan ukuran buffer propertyData harus untuk properti adaptor tertentu.

Mengembalikan

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahanHRESULT akan dikembalikan.

Mengembalikan nilai Deskripsi
DXGI_ERROR_INVALID_CALL Jenis properti yang ditentukan dalam properti tidak dikenali oleh sistem operasi (OS) ini. Panggil IsPropertySupported untuk mengonfirmasi bahwa jenis properti tersedia untuk adaptor dan sistem operasi (OS) ini.
DXGI_ERROR_UNSUPPORTED Tipe properti yang ditentukan dalam properti tidak didukung oleh adaptor. Panggil IsPropertySupported untuk mengonfirmasi bahwa jenis properti tersedia untuk adaptor dan sistem operasi (OS) ini.
E_INVALIDARG Ukuran buffer yang tidak cukup disediakan dalam propertyData. Panggil GetPropertySize untuk menentukan ukuran buffer propertyData harus untuk properti adaptor tertentu.
E_POINTER nullptr disediakan untuk propertyData.

Keterangan

Anda dapat memanggil GetProperty pada adaptor yang tidak lagi valid—fungsi tidak akan gagal sebagai akibatnya. Fungsi ini nol dari buffer propertyData sebelum mengisinya.

Lihat juga

IDXCoreAdapter, Referensi DXCore, Menggunakan DXCore untuk menghitung adaptor