METODE IDCompositionDevice2::CreateSurfaceFactory (dcomp.h)
Membuat objek pabrik permukaan Microsoft DirectComposition, yang dapat digunakan untuk membuat permukaan DirectComposition atau objek permukaan virtual lainnya
Sintaks
HRESULT CreateSurfaceFactory(
[in] IUnknown *renderingDevice,
[out] IDCompositionSurfaceFactory **surfaceFactory
);
Parameter
[in] renderingDevice
Penunjuk ke perangkat DirectX yang akan digunakan untuk membuat objek permukaan DirectComposition. Harus berupa penunjuk ke objek yang mengimplementasikan antarmuka IDXGIDevice atau ID2D1Device . Parameter ini tidak boleh NULL.
[out] surfaceFactory
Objek pabrik permukaan yang baru dibuat. Parameter ini tidak boleh NULL.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.
Keterangan
Pabrik permukaan memungkinkan aplikasi untuk secara bersamaan menggunakan lebih dari satu perangkat DXGI atau Direct2D tunggal dengan DirectComposition. Setiap pabrik permukaan memiliki asosiasi permanen dengan satu perangkat DXGI atau Direct2D, tetapi perangkat DirectComposition mungkin memiliki sejumlah pabrik permukaan.
Setiap pabrik permukaan mengelola sumber daya secara independen dari yang lain. Secara khusus, DirectComposition mengumpulkan alokasi permukaan untuk mengurangi alokasi permukaan dan biaya dealokasi. Kumpulan ini dilakukan berdasarkan pabrik per permukaan.
Jika fungsi DCompositionCreateDevice2 dipanggil dengan parameter renderingDevice non-NULL, objek perangkat DirectComposition yang dikembalikan memiliki pabrik permukaan implisit di bawah penutup yang terkait dengan perangkat penyajian yang diberikan. Pabrik permukaan implisit ini digunakan untuk melayani metode IDCompositionDevice::CreateSurface, IDCompositionDevice::CreateVirtualSurface, IDCompositionDevice2::CreateSurface dan IDCompositionDevice2::CreateVirtualSurface .
Objek permukaan tetap hidup selama salah satu permukaan atau permukaan virtual yang dibuatnya tetap hidup, baik secara langsung karena aplikasi memegang referensi langsung, atau secara tidak langsung karena satu atau beberapa permukaan tersebut terkait dengan satu atau beberapa objek visual.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8.1 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 R2 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | dcomp.h |
| Pustaka | Dcomp.lib |
| DLL | Dcomp.dll |