Metode IDirectInputJoyConfig8::OpenTypeKey (dinputd.h)

  • Artikel

Metode IDirectInputJoyConfig8::OpenTypeKey membuka kunci registri yang terkait dengan jenis joystick.

Sintaks

HRESULT OpenTypeKey(
  LPCWSTR unnamedParam1,
  DWORD   unnamedParam2,
  PHKEY   unnamedParam3
);

Parameter

unnamedParam1

Menunjuk ke nama jenis. Nama tipe tidak boleh melebihi MAX_PATH karakter, termasuk karakter null yang dihentikan. Nama tidak dapat dimulai dengan karakter "#". Jenis yang dimulai dengan "#" dicadangkan oleh DirectInput.

unnamedParam2

Menentukan masker akses keamanan registri. Ini bisa menjadi salah satu nilai yang diizinkan oleh fungsi RegOpenKeyEx . Jika akses tulis diminta, konfigurasi joystick harus terlebih dahulu diperoleh. Jika hanya akses baca yang diminta, maka akuisisi tidak diperlukan.

unnamedParam3

Menunjuk ke kunci registri yang dibuka, pada keberhasilan.

Nilai kembali

Mengembalikan DI_OK jika berhasil; jika tidak, mengembalikan salah satu nilai kesalahan COM berikut:

Menampilkan kode Deskripsi
DIERR_NOTACQUIRED
Konfigurasi Joystick belum diperoleh. Anda harus memanggil IDirectInputJoyConfig8::Acquire sebelum Anda dapat membuka kunci konfigurasi jenis joystick untuk menulis.
DIERR_INVALIDPARAM
Satu atau beberapa parameter tidak valid.
MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIN32, ErrorCode)
Kode kesalahan Win32 jika akses ke kunci ditolak oleh izin registri atau beberapa faktor eksternal lainnya.

Keterangan

Aplikasi panel kontrol dapat menggunakan kunci registri yang dibuka oleh metode ini untuk menyimpan informasi persisten per jenis, seperti parameter konfigurasi global. Informasi privat tersebut harus disimpan dalam subkuntang bernama OEM; jangan menyimpan informasi privat di kunci jenis utama. Aplikasi panel kontrol juga dapat menggunakan kunci ini untuk membaca informasi konfigurasi, seperti string yang digunakan untuk perintah kalibrasi perangkat. Aplikasi harus menggunakan RegCloseKey untuk menutup kunci registri.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header dinputd.h (termasuk Dinputd.h)