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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk