Interfaccia IMMDeviceEnumerator (mmdeviceapi.h)

L'interfaccia IMMDeviceEnumerator fornisce metodi per enumerare le risorse dei dispositivi multimediali. Nell'implementazione corrente dell'API MMDevice, le uniche risorse del dispositivo che questa interfaccia può enumerare sono dispositivi endpoint audio. Un client ottiene un riferimento a un'interfaccia IMMDeviceEnumerator chiamando la funzione CoCreateInstance , come descritto in precedenza (vedere l'API MMDevice).

Le risorse del dispositivo enumerate dai metodi nell'interfaccia IMMDeviceEnumerator sono rappresentate come raccolte di oggetti con interfacce IMMDevice . Una raccolta ha un'interfaccia IMMDeviceCollection . Il metodo IMMDeviceEnumerator::EnumAudioEndpoints crea una raccolta di dispositivi.

Per ottenere un puntatore all'interfaccia IMMDevice di un elemento in una raccolta di dispositivi, il client chiama il metodo IMMDeviceCollection::Item .

Per esempi di codice che usano l'interfaccia IMMDeviceEnumerator , vedere gli argomenti seguenti:

Ereditarietà

L'interfaccia IMMDeviceEnumerator eredita dall'interfaccia IUnknown . IMMDeviceEnumerator include anche questi tipi di membri:

Metodi

L'interfaccia IMMDeviceEnumerator include questi metodi.

 
IMMDeviceEnumerator::EnumAudioEndpoints

Il metodo EnumAudioEndpoints genera una raccolta di dispositivi endpoint audio che soddisfano i criteri specificati.
IMMDeviceEnumerator::GetDefaultAudioEndpoint

Il metodo GetDefaultAudioEndpoint recupera l'endpoint audio predefinito per la direzione e il ruolo del flusso di dati specificati.
IMMDeviceEnumerator::GetDevice

Il metodo GetDevice recupera un dispositivo endpoint audio identificato da una stringa ID endpoint.
IMMDeviceEnumerator::RegisterEndpointNotificationCallback

Il metodo RegisterEndpointNotificationCallback registra l'interfaccia di callback di notifica di un client.
IMMDeviceEnumerator::UnregisterEndpointNotificationCallback

Il metodo UnregisterEndpointNotificationCallback elimina la registrazione di un'interfaccia di notifica registrata nel client registrato in una chiamata precedente al metodo IMMDeviceEnumerator::RegisterEndpointNotificationCallback.

Requisiti

   
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

Interfacce audio principali

Interfaccia IMMDevice

Interfaccia IMMDeviceCollection

IMMDeviceCollection::Item

IMMDeviceEnumerator::EnumAudioEndpoints

MMDevice API