Recupero di un nome dell'interfaccia dispositivo
In Windows Me e Windows 2000 e versioni successive, le funzioni multimediali windows waveInMessage, waveOutMessage, midiInMessage, midiOutMessage e mixerMessage possono recuperare il nome dell'interfaccia del dispositivo di un dispositivo. Queste informazioni sono utili per i programmi applicazione che devono identificare il dispositivo all'esterno dell'API waveIn, waveOut, midiIn, midiOut o mixer. All'interno di una di queste API, un ID dispositivo è sufficiente.
Il gestore Plug and Play genera un nome dell'interfaccia del dispositivo per identificare in modo univoco ogni dispositivo che enumera. Un'applicazione deve considerare la stringa contenente un nome dell'interfaccia del dispositivo come opaca. Per altre informazioni sulle interfacce del dispositivo, vedere Introduzione alle interfacce dispositivo.
Il file di intestazione Mmddk.h definisce due costanti di messaggio per ottenere i nomi dell'interfaccia del dispositivo:
Il primo messaggio ottiene le dimensioni in byte del buffer necessario per contenere la stringa contenente il nome dell'interfaccia del dispositivo. Il secondo messaggio recupera la stringa del nome in un buffer delle dimensioni necessarie.
Il sistema intercetta e gestisce i messaggi di DRV_QUERYDEVICEINTERFACESIZE e DRV_QUERYDEVICEINTERFACE senza inviare i messaggi al driver del dispositivo.
Il primo parametro della funzione xxxMessage è l'ID del dispositivo, che il chiamante deve eseguire il cast al tipo di handle appropriato: HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT o HMIXER. Per altre informazioni sulle funzioni del messaggio xxx, vedere Messaggi del dispositivo intercettati dal sistema.