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)

Vedi anche

DRV_QUERYDEVICEINTERFACESIZE

midiInMessage

midiOutMessage

mixerMessage

Messaggi dispositivo intercettati dal sistema

waveInMessage

waveOutMessage