Método IMMDeviceCollection::Item (mmdeviceapi.h)

  • Artículo

El método Item recupera un puntero al elemento especificado en la colección de dispositivos.

Sintaxis

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

Parámetros

[in] nDevice

Número de dispositivo. Si la colección contiene n dispositivos, los dispositivos se numeran de 0 a n a 1.

[out] ppDevice

Puntero a una variable de puntero en la que el método escribe la dirección de la interfaz IMMDevice del elemento especificado en la colección de dispositivos. A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada a Item , *ppDevice es NULL.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_POINTER
 El parámetro ppDevice es NULL.
E_INVALIDARG
 El parámetro nDevice no es un número de dispositivo válido.

Comentarios

Este método recupera un puntero a la interfaz IMMDevice del elemento especificado en la colección de dispositivos. Cada elemento de la colección es un objeto de punto de conexión que representa un dispositivo de punto de conexión de audio. El autor de la llamada selecciona un dispositivo de la colección de dispositivos especificando el número de dispositivo. Para una colección de n dispositivos, los números de dispositivo válidos oscilan entre 0 y n– 1. Para obtener un recuento de los dispositivos de una colección, llame al método IMMDeviceCollection::GetCount .

Para obtener un ejemplo de código que llama al método Item , vea Propiedades del dispositivo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mmdeviceapi.h

Consulte también

IMMDevice (Interfaz)

IMMDeviceCollection (Interfaz)

IMMDeviceCollection::GetCount