METODE IDXGIKeyedMutex::ReleaseSync (dxgi.h)

Artikel
08/23/2023

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);