Fungsi CreateSemaphoreExA (winbase.h)
Membuat atau membuka objek semaphore bernama atau tanpa nama dan mengembalikan handel ke objek .
Sintaks
HANDLE CreateSemaphoreExA(
[in, optional] LPSECURITY_ATTRIBUTES lpSemaphoreAttributes,
[in] LONG lInitialCount,
[in] LONG lMaximumCount,
[in, optional] LPCSTR lpName,
DWORD dwFlags,
[in] DWORD dwDesiredAccess
);
Parameter
[in, optional] lpSemaphoreAttributes
Penunjuk ke struktur SECURITY_ATTRIBUTES . Jika parameter ini NULL, handel semaphore tidak dapat diwariskan oleh proses anak.
Anggota lpSecurityDescriptor dari struktur menentukan deskriptor keamanan untuk semaphore baru. Jika parameter ini ADALAH NULL, semaphore mendapatkan deskriptor keamanan default. ACL dalam deskriptor keamanan default untuk semaphore berasal dari token utama atau peniruan dari pembuat.
[in] lInitialCount
Jumlah awal untuk objek semaphore. Nilai ini harus lebih besar dari atau sama dengan nol dan kurang dari atau sama dengan lMaximumCount. Status semaphore disinyalkan ketika jumlahnya lebih besar dari nol dan tidak ditandatangani ketika nol. Jumlah menurun satu setiap kali fungsi tunggu merilis utas yang menunggu semaphore. Jumlah ditingkatkan dengan jumlah tertentu dengan memanggil fungsi ReleaseSemaphore .
[in] lMaximumCount
Jumlah maksimum untuk objek semaphore. Nilai ini harus lebih besar dari nol.
[in, optional] lpName
Penunjuk ke string yang dihentikan null yang menentukan nama objek semaphore. Nama terbatas pada karakter MAX_PATH . Perbandingan nama peka huruf besar/kecil.
Jika lpName cocok dengan nama objek semaphore bernama yang ada, parameter lInitialCount dan lMaximumCount diabaikan karena telah diatur oleh proses pembuatan. Jika parameter lpSemaphoreAttributes bukan NULL, parameter menentukan apakah handel dapat diwariskan.
Jika lpName adalah NULL, objek semaphore dibuat tanpa nama.
Jika lpName cocok dengan nama peristiwa, mutex, timer, pekerjaan, atau objek pemetaan file yang ada, fungsi gagal dan fungsi GetLastError mengembalikan ERROR_INVALID_HANDLE. Ini terjadi karena objek ini memiliki namespace yang sama.
Nama dapat memiliki awalan "Global" atau "Lokal" untuk secara eksplisit membuat objek di namespace layanan global atau sesi. Sisa nama dapat berisi karakter apa pun kecuali karakter garis miring terbelakang (\). Untuk informasi selengkapnya, lihat Namespace Objek Kernel. Pengalihan pengguna cepat diimplementasikan menggunakan sesi Layanan Terminal. Nama objek kernel harus mengikuti pedoman yang diuraikan untuk Layanan Terminal sehingga aplikasi dapat mendukung beberapa pengguna.
Objek dapat dibuat di namespace privat. Untuk informasi selengkapnya, lihat Namespace Objek.
dwFlags
Parameter ini dicadangkan dan harus 0.
[in] dwDesiredAccess
Masker akses untuk objek semaphore. Untuk daftar hak akses, lihat Sinkronisasi Keamanan Objek dan Hak Akses.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke objek semaphore. Jika objek semaphore bernama ada sebelum panggilan fungsi, fungsi mengembalikan handel ke objek yang ada dan GetLastError mengembalikan ERROR_ALREADY_EXISTS.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Status objek semaphore ditandai ketika jumlahnya lebih besar dari nol, dan tidak ditandatangani ketika jumlahnya sama dengan nol. Parameter lInitialCount menentukan jumlah awal. Jumlahnya tidak boleh kurang dari nol atau lebih besar dari nilai yang ditentukan dalam parameter lMaximumCount .
Setiap utas proses panggilan dapat menentukan handel semaphore-object dalam panggilan ke salah satu fungsi tunggu. Fungsi tunggu objek tunggal kembali saat status objek yang ditentukan disinyalkan. Fungsi tunggu beberapa objek dapat diinstruksikan untuk mengembalikan baik ketika salah satu atau ketika semua objek yang ditentukan diberi sinyal. Saat fungsi tunggu kembali, utas tunggu dirilis untuk melanjutkan eksekusinya. Setiap kali utas menyelesaikan tunggu objek semaphore, jumlah objek semaphore dikurangi satu. Ketika utas selesai, alur memanggil fungsi ReleaseSemaphore , yang menaikkan jumlah objek semaphore.
Beberapa proses dapat memiliki handel dari objek semaphore yang sama, memungkinkan penggunaan objek untuk sinkronisasi antarproses. Mekanisme berbagi objek berikut tersedia:
- Proses anak yang dibuat oleh fungsi CreateProcess dapat mewarisi handel ke objek semaphore jika parameter lpSemaphoreAttributes dari pewarisan yang diaktifkan CreateSemaphoreEx .
- Proses dapat menentukan handel semaphore-object dalam panggilan ke fungsi DuplicateHandle untuk membuat handel duplikat yang dapat digunakan oleh proses lain.
- Proses dapat menentukan nama objek semaphore dalam panggilan ke [OpenSemaphore](.. Fungsi /synchapi/nf-synchapi-signalobjectandwait.md) atau CreateSemaphoreEx .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | winbase.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |
Lihat juga
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk