METODE IDXGIKeyedMutex::ReleaseSync (dxgi.h)
Dengan menggunakan kunci, merilis akses penyajian eksklusif ke sumber daya bersama.
Sintaks
HRESULT ReleaseSync(
UINT64 Key
);
Parameter
Key
Jenis: UINT64
Nilai yang menunjukkan perangkat mana yang akan diberikan akses. Metode ini berhasil ketika perangkat yang saat ini memiliki permukaan memanggil metode ReleaseSync menggunakan nilai yang sama. Nilai ini bisa menjadi nilai UINT64 apa pun.
Nilai kembali
Jenis: HRESULT
Mengembalikan S_OK jika berhasil.
Jika perangkat mencoba merilis mutex kunci yang tidak valid atau dimiliki oleh perangkat, ReleaseSync mengembalikan E_FAIL.
Keterangan
Metode ReleaseSync melepaskan kunci ke permukaan yang dibagikan antara beberapa perangkat. Metode ini menggunakan kunci untuk menentukan perangkat mana yang saat ini memiliki akses eksklusif ke permukaan.
Ketika permukaan dibuat menggunakan nilai D3D10_RESOURCE_MISC_SHARED_KEYEDMUTEX enumerasi D3D10_RESOURCE_MISC_FLAG , Anda harus memanggil metode IDXGIKeyedMutex::AcquireSync sebelum merender ke permukaan. Anda harus memanggil metode ReleaseSync ketika Anda selesai merender ke permukaan.
Setelah Anda memanggil metode ReleaseSync , sumber daya bersama tidak diatur dari alur penyajian.
Untuk memperoleh referensi ke objek mutex kunci sumber daya bersama, panggil metode QueryInterface dari sumber daya dan berikan UUID antarmuka IDXGIKeyedMutex . Untuk informasi selengkapnya tentang memperoleh referensi ini, lihat contoh kode berikut.
Contoh
Memperoleh Keyed Mutex
Contoh kode berikut menunjukkan cara memperoleh kunci ke sumber daya bersama dan cara menentukan kunci saat dirilis.
// pDesc has already been set up with texture description.
pDesc.MiscFlags = D3D10_RESOURCE_MISC_SHARED_KEYEDMUTEX;
// Create a shared texture resource.
pD3D10DeviceD->CreateTexture2D(pDesc, NULL, pD3D10Texture);
// Acquire a reference to the keyed mutex.
pD3D10Texture->QueryInterface(_uuidof(IDXGIKeyedMutex), pDXGIKeyedMutex);
// Acquire a lock to the resource.
pDXGIKeyedMutex->AcquireSync(0, INFINITE);
// Release the lock and specify a key.
pDXGIKeyedMutex->ReleaseSync(1);
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | dxgi.h |
Pustaka | DXGI.lib |