Antarmuka IPortableDevice (portabledeviceapi.h)

Antarmuka IPortableDevice menyediakan akses ke perangkat portabel.

Untuk membuat dan membuka antarmuka ini, pertama-tama panggil CoCreateInstance dengan CLSID_PortableDeviceFTM atau CLSID_PortableDevice untuk mengambil antarmuka IPortableDevice , lalu panggil Buka untuk membuka koneksi ke perangkat.

Warisan

Antarmuka IPortableDevice mewarisi dari antarmuka IUnknown . IPortableDevice juga memiliki jenis anggota berikut:

Metode

Antarmuka IPortableDevice memiliki metode ini.

IPortableDevice::Advise Metode Saran mendaftarkan panggilan balik yang ditentukan aplikasi yang menerima peristiwa perangkat.
IPortableDevice::Cancel Metode Batal membatalkan operasi yang tertunda pada antarmuka ini.
IPortableDevice::Capabilities Metode Kemampuan mengambil antarmuka yang digunakan untuk mengkueri kemampuan perangkat portabel.
IPortableDevice::Close Metode Tutup menutup koneksi dengan perangkat.
IPortableDevice::Content Metode Konten mengambil antarmuka yang dapat Anda gunakan untuk mengakses objek pada perangkat.
IPortableDevice::GetPnPDeviceID Metode GetPnPDeviceID mengambil pengidentifikasi perangkat Plug and Play (PnP) yang digunakan aplikasi untuk membuka perangkat.
IPortableDevice::Open Metode Buka membuka koneksi antara aplikasi dan perangkat.
IPortableDevice::SendCommand Metode SendCommand mengirim perintah ke perangkat dan mengambil hasilnya secara sinkron.
IPortableDevice::Unadvise Metode Tidak Diawasi membatalkan pendaftaran klien dari menerima pemberitahuan panggilan balik. Anda harus memanggil metode ini jika Anda memanggil Advise sebelumnya.

Keterangan

Antarmuka klien dirancang untuk digunakan untuk objek WPD apa pun; tidak perlu membuat instans baru untuk setiap objek yang dirujuk oleh aplikasi. Setelah aplikasi membuka instans antarmuka IPortableDevice , aplikasi harus terbuka dan menyimpan cache antarmuka klien WPD lainnya yang akan diperlukannya.

Untuk Windows 7, IPortableDevice mendukung dua CLSID untuk CoCreateInstance. CLSID_PortableDevice mengembalikan penunjuk IPortableDevice yang tidak mengagregasi marshaler utas bebas; CLSID_PortableDeviceFTM adalah CLSID baru yang mengembalikan pointer IPortableDevice yang menggabungkan marshaler utas bebas. Kedua pointer mendukung fungsionalitas yang sama.

Aplikasi yang tinggal di Apartemen Single Threaded harus menggunakan CLSID_PortableDeviceFTM karena ini menghilangkan overhead marshaling pointer antarmuka. CLSID_PortableDevice masih didukung untuk aplikasi warisan.

Persyaratan

Target Platform	Windows
Header	portabledeviceapi.h

Lihat juga

Antarmuka Klien