Fungsi KsOpenDefaultDevice (ksproxy.h)

Fungsi KsOpenDefaultDevice membuka handel ke perangkat pertama yang tercantum dalam kategori Plug and Play (PnP) yang ditentukan.

Sintaks

KSDDKAPI HRESULT KsOpenDefaultDevice(
  [in]  REFGUID     Category,
  [in]  ACCESS_MASK Access,
  [out] PHANDLE     DeviceHandle
);

Parameter

[in] Category

Pengidentifikasi kategori PnP untuk menghitung.

[in] Access

Bitmask ACCESS_MASK yang menentukan cara mengakses perangkat default.

[out] DeviceHandle

Penunjuk ke variabel yang menerima handel ke perangkat default yang dibuka.

Nilai kembali

Mengembalikan NOERROR jika berhasil; jika tidak, mengembalikan kode kesalahan.

Keterangan

Fungsi KsOpenDefaultDevice meneruskan pointer ke Kategori dalam panggilan ke fungsi SetupDiGetClassDevs untuk mendapatkan handel ke daftar perangkat PnP. Untuk informasi selengkapnya tentang bitmask ACCESS_MASK dan SetupDiGetClassDevs, lihat dokumentasi Microsoft Windows SDK.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	ksproxy.h (termasuk Ksproxy.h)
Pustaka	Ksproxy.lib