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

O método Item recupera um ponteiro para o item especificado na coleção de dispositivos.

Sintaxe

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

Parâmetros

[in] nDevice

O número do dispositivo. Se a coleção contiver n dispositivos, os dispositivos serão numerados de 0 a n– 1.

[out] ppDevice

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface IMMDevice do item especificado na coleção de dispositivos. Por meio desse método, o chamador obtém uma referência contada para a interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada item falhar, *ppDevice será NULL.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
O parâmetro ppDevice é NULL.
E_INVALIDARG
O parâmetro nDevice não é um número de dispositivo válido.

Comentários

Esse método recupera um ponteiro para a interface IMMDevice do item especificado na coleção de dispositivos. Cada item na coleção é um objeto de ponto de extremidade que representa um dispositivo de ponto de extremidade de áudio. O chamador seleciona um dispositivo na coleção de dispositivos especificando o número do dispositivo. Para uma coleção de n dispositivos, os números de dispositivo válidos variam de 0 a n– 1. Para obter uma contagem dos dispositivos em uma coleção, chame o método IMMDeviceCollection::GetCount .

Para obter um exemplo de código que chama o método Item , consulte Propriedades do dispositivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmdeviceapi.h

Confira também

IMMDevice Interface

IMMDeviceCollection Interface

IMMDeviceCollection::GetCount