funzione DRV_QUERYDEVICEINTERFACESIZE
La DRV_QUERYDEVICEINTERFACESIZE query del messaggio per le dimensioni del buffer necessarie per contenere il nome dell'interfaccia del dispositivo.
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_QUERYDEVICEINTERFACESIZE quando chiama xxxMessage per elaborare il messaggio del dispositivo.dwParam1
Puntatore alle dimensioni del buffer. Questo parametro punta a una variabile ULONG in cui la funzione scrive le dimensioni del buffer necessarie in byte. Le dimensioni includono spazio di archiviazione per la terminazione null della stringa del nome. La dimensione è zero se l'ID dispositivo identifica un dispositivo che non ha alcuna interfaccia del dispositivo.dwParam2
Non utilizzato. Impostare questo parametro su zero.
Valore restituito
La funzione xxxMessage restituisce MMSYSERR_NOERROR se il messaggio viene gestito correttamente. In caso contrario, restituisce un codice di errore appropriato.
Commenti
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 del dispositivo. Per informazioni generali sulle funzioni xxxMessage intercettate dal sistema, vedere Messaggi del dispositivo intercettati dal sistema.
Le dimensioni del buffer recuperate da questo messaggio vengono espresse come conteggio byte. Specifica le dimensioni del buffer necessario per contenere la stringa Unicode con terminazione null contenente il nome dell'interfaccia del dispositivo. Il chiamante alloca un buffer delle dimensioni specificate e usa il messaggio DRV_QUERYDEVICEINTERFACE per recuperare la stringa del nome dell'interfaccia del dispositivo.
Per altre informazioni, vedere Recupero di un nome dell'interfaccia dispositivo.
Requisiti
Piattaforma di destinazione |
Desktop |
Versione |
Supportato in Microsoft Windows Me e Windows 2000 e nei sistemi operativi successivi. |
Intestazione |
Mmddk.h (include Mmddk.h) |
Vedi anche
Recupero di un nome dell'interfaccia dispositivo