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 |
|---|---|
|
O parâmetro ppDevice é NULL. |
|
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 |