METODE IMDServiceProvider2::CreateDevice (mswmdm.h)
Metode CreateDevice dipanggil oleh Windows Media Device Manager untuk mendapatkan objek IMDSPDevice yang sesuai dengan perangkat kanonis yang diperoleh dari subsistem PnP. Metode ini harus diimplementasikan untuk dukungan PnP dan Windows Explorer, tetapi jika tidak, itu opsional. Untuk informasi selengkapnya, lihat Antarmuka Wajib dan Opsional.
Sintaks
HRESULT CreateDevice(
[in] LPCWSTR pwszDevicePath,
[out] DWORD *pdwCount,
[out] IMDSPDevice ***pppDeviceArray
);
Parameter
[in] pwszDevicePath
Penunjuk ke string karakter lebar yang dihentikan null yang berisi jalur perangkat perangkat yang terdeteksi oleh Windows Media Device Manager. Nama ini diperoleh dari subsistem PnP, dan merupakan nama kanonis ditambah "$ # ", di mana # adalah angka bertahap otomatis. Nama ini dapat diteruskan langsung ke fungsi seperti CreateFile untuk mendapatkan akses ke objek perangkat kernel yang mendasar. Penyedia layanan harus membuat objek IMDSPDevice pembungkus untuk perangkat ini.
[out] pdwCount
Penunjuk ke DWORD yang berisi jumlah objek IMDSPDevice yang dibuat.
[out] pppDeviceArray
Array antarmuka IMDSPDevice yang mewakili perangkat. Biasanya, hanya ada satu elemen array, tetapi penyedia layanan dapat membuat lebih dari satu objek IMDSPDevice yang sesuai dengan nama jalur perangkat jika membuat objek IMDSPDevice untuk setiap penyimpanan tingkat atas. Hal ini dapat berubah di masa mendatang, dan jumlahnya mungkin dibatasi hingga 1.
Nilai kembali
Jika metode berhasil, metode akan mengembalikan S_OK. Jika metode gagal, metode mengembalikan kode kesalahan Windows Media Device Manager.
Keterangan
Pengelola Perangkat Windows Media memanggil metode ini ketika aplikasi dimulai, atau ketika perangkat yang sesuai Plug and Play tersambung dengan komputer.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | mswmdm.h |
| Pustaka | Mssachlp.lib |