Compartilhar via


Interface IMMDeviceEnumerator (mmdeviceapi.h)

A interface IMMDeviceEnumerator fornece métodos para enumerar recursos de dispositivo multimídia. Na implementação atual da API MMDevice, os únicos recursos de dispositivo que essa interface pode enumerar são dispositivos de ponto de extremidade de áudio. Um cliente obtém uma referência a uma interface IMMDeviceEnumerator chamando a função CoCreateInstance , conforme descrito anteriormente (consulte API MMDevice).

Os recursos do dispositivo enumerados pelos métodos na interface IMMDeviceEnumerator são representados como coleções de objetos com interfaces IMMDevice . Uma coleção tem uma interface IMMDeviceCollection . O método IMMDeviceEnumerator::EnumAudioEndpoints cria uma coleção de dispositivos.

Para obter um ponteiro para a interface IMMDevice de um item em uma coleção de dispositivos, o cliente chama o método IMMDeviceCollection::Item .

Para obter exemplos de código que usam a interface IMMDeviceEnumerator , consulte os seguintes tópicos:

Herança

A interface IMMDeviceEnumerator herda da interface IUnknown . IMMDeviceEnumerator também tem esses tipos de membros:

Métodos

A interface IMMDeviceEnumerator tem esses métodos.

 
IMMDeviceEnumerator::EnumAudioEndpoints

O método EnumAudioEndpoints gera uma coleção de dispositivos de ponto de extremidade de áudio que atendem aos critérios especificados.
IMMDeviceEnumerator::GetDefaultAudioEndpoint

O método GetDefaultAudioEndpoint recupera o ponto de extremidade de áudio padrão para a direção e a função de fluxo de dados especificadas.
IMMDeviceEnumerator::GetDevice

O método GetDevice recupera um dispositivo de ponto de extremidade de áudio identificado por uma cadeia de caracteres de ID do ponto de extremidade.
IMMDeviceEnumerator::RegisterEndpointNotificationCallback

O método RegisterEndpointNotificationCallback registra a interface de retorno de chamada de notificação de um cliente.
IMMDeviceEnumerator::UnregisterEndpointNotificationCallback

O método UnregisterEndpointNotificationCallback exclui o registro de uma interface de notificação que o cliente registrou em uma chamada anterior para o método IMMDeviceEnumerator::RegisterEndpointNotificationCallback.

Requisitos

   
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

Principais interfaces de áudio

IMMDevice Interface

IMMDeviceCollection Interface

IMMDeviceCollection::Item

IMMDeviceEnumerator::EnumAudioEndpoints

MMDevice API