Metodo IMMDeviceCollection::Item (mmdeviceapi.h)

Il metodo Item recupera un puntatore all'elemento specificato nella raccolta di dispositivi.

Sintassi

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

Parametri

[in] nDevice

Numero del dispositivo. Se la raccolta contiene n dispositivi, i dispositivi vengono numerati da 0 a n- 1.

[out] ppDevice

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IMMDevice dell'elemento specificato nella raccolta di dispositivi. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata all'elemento non riesce, *ppDevice è NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito	Descrizione
E_POINTER	Il parametro ppDevice è NULL.
E_INVALIDARG	Il parametro nDevice non è un numero di dispositivo valido.

Commenti

Questo metodo recupera un puntatore all'interfaccia IMMDevice dell'elemento specificato nella raccolta di dispositivi. Ogni elemento della raccolta è un oggetto endpoint che rappresenta un dispositivo endpoint audio. Il chiamante seleziona un dispositivo dalla raccolta di dispositivi specificando il numero di dispositivo. Per una raccolta di n dispositivi, i numeri di dispositivo validi sono compresi tra 0 e n- 1. Per ottenere un conteggio dei dispositivi in una raccolta, chiamare il metodo IMMDeviceCollection::GetCount .

Per un esempio di codice che chiama il metodo Item , vedere Proprietà dispositivo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mmdeviceapi.h

Vedi anche

Interfaccia IMMDevice

Interfaccia IMMDeviceCollection

IMMDeviceCollection::GetCount