funzione DRV_QUERYDEVICEINTERFACE
Il DRV_QUERYDEVICEINTERFACE query di messaggio per il nome dell'interfaccia del dispositivo di un dispositivo waveIn, waveOut, midiIn, midiOut o mixer .
Sintassi
DWORD xxxMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
Parametri
uDeviceID
Specifica l'ID del dispositivo di destinazione.Umsg
Il chiamante imposta questo parametro su DRV_QUERYDEVICEINTERFACE quando chiama xxxMessage per elaborare il messaggio del dispositivo.dwParam1
Puntatore a un buffer allocato dal chiamante in cui la funzione scrive una stringa Unicode con terminazione Null contenente il nome dell'interfaccia del dispositivo. Se il dispositivo non ha interfaccia del dispositivo, la lunghezza della stringa è zero.dwParam2
Specifica le dimensioni del buffer in byte. Si tratta di un parametro di input per la funzione . Il chiamante deve specificare una dimensione maggiore o uguale alla dimensione del buffer recuperata dal messaggio DRV_QUERYDEVICEINTERFACESIZE .
Valore restituito
La funzione xxxMessage restituisce MMSYSERR_NOERROR se il messaggio viene gestito correttamente. In caso contrario, restituisce un codice di errore appropriato.
Commenti
Il messaggio DRV_QUERYDEVICEINTERFACE è supportato in Windows Me e Windows 2000 e versioni successive. Questo messaggio è valido solo per le funzioni waveInMessage, waveOutMessage, midiInMessage, midiOutMessage e mixerMessage . Il sistema intercetta questo messaggio e restituisce il valore appropriato senza inviare il messaggio al driver di dispositivo. Per informazioni generali sulle funzioni xxxMessage intercettate dal sistema, vedere Messaggi del dispositivo intercettato dal sistema.
Le due costanti di messaggio seguenti vengono usate insieme allo scopo di ottenere i nomi dell'interfaccia del dispositivo:
DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE
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.
Per altre informazioni, vedere Recupero di un nome di interfaccia dispositivo.
Requisiti
Piattaforma di destinazione |
Desktop |
Intestazione |
Mmddk.h (include Mmddk.h) |