IMMDeviceCollection::Metode item (mmdeviceapi.h)

  • Artikel

Metode Item mengambil penunjuk ke item yang ditentukan dalam koleksi perangkat.

Sintaks

HRESULT Item(
  [in]  UINT      nDevice,
  [out] IMMDevice **ppDevice
);

Parameter

[in] nDevice

Nomor perangkat. Jika koleksi berisi perangkat n , perangkat diberi nomor 0 hingga n– 1.

[out] ppDevice

Pointer ke variabel pointer tempat metode menulis alamat antarmuka IMMDevice dari item yang ditentukan dalam koleksi perangkat. Melalui metode ini, pemanggil mendapatkan referensi yang dihitung ke antarmuka. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan Item gagal, *ppDeviceADALAH NULL.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode Deskripsi
E_POINTER
 Parameter ppDevice adalah NULL.
E_INVALIDARG
 Parameter nDevice bukan nomor perangkat yang valid.

Keterangan

Metode ini mengambil pointer ke antarmuka IMMDevice dari item yang ditentukan dalam koleksi perangkat. Setiap item dalam koleksi adalah objek titik akhir yang mewakili perangkat titik akhir audio. Pemanggil memilih perangkat dari koleksi perangkat dengan menentukan nomor perangkat. Untuk kumpulan perangkat n , nomor perangkat yang valid berkisar antara 0 hingga n– 1. Untuk mendapatkan hitungan perangkat dalam koleksi, panggil metode IMMDeviceCollection::GetCount .

Untuk contoh kode yang memanggil metode Item , lihat Properti Perangkat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header mmdeviceapi.h

Lihat juga

Antarmuka IMMDevice

Antarmuka IMMDeviceCollection

IMMDeviceCollection::GetCount