DRV_QUERYDEVICEINTERFACE fonction
Le DRV_QUERYDEVICEINTERFACE requêtes de message pour le nom de l’interface d’appareil d’un appareil waveIn, waveOut, midiIn, midiOut ou mixer .
Syntaxe
DWORD xxxMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
Paramètres
uDeviceID
Spécifie l’ID de l’appareil cible.uMsg
L’appelant définit ce paramètre sur DRV_QUERYDEVICEINTERFACE lorsqu’il appelle xxxMessage pour traiter ce message d’appareil.dwParam1
Pointeur vers une mémoire tampon allouée à l’appelant dans laquelle la fonction écrit une chaîne Unicode terminée par null contenant le nom de l’interface de l’appareil. Si l’appareil n’a pas d’interface d’appareil, la longueur de chaîne est égale à zéro.dwParam2
Spécifie la taille de la mémoire tampon en octets. Il s’agit d’un paramètre d’entrée de la fonction. L’appelant doit spécifier une taille supérieure ou égale à la taille de mémoire tampon récupérée par le message DRV_QUERYDEVICEINTERFACESIZE .
Valeur retournée
La fonction xxxMessage retourne MMSYSERR_NOERROR si le message est géré correctement. Sinon, il retourne un code d’erreur approprié.
Remarques
Le message DRV_QUERYDEVICEINTERFACE est pris en charge dans Windows Me et Windows 2000 et versions ultérieures. Ce message est valide uniquement pour les fonctions waveInMessage, waveOutMessage, midiInMessage, midiOutMessage et mixerMessage . Le système intercepte ce message et retourne la valeur appropriée sans envoyer le message au pilote de périphérique. Pour obtenir des informations générales sur les fonctions xxxMessage interceptées par le système, consultez Messages d’appareil interceptés par le système.
Les deux constantes de message suivantes sont utilisées ensemble dans le but d’obtenir des noms d’interface d’appareil :
DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE
Le premier message obtient la taille en octets de la mémoire tampon nécessaire pour contenir la chaîne contenant le nom de l’interface de l’appareil. Le deuxième message récupère la chaîne de nom dans une mémoire tampon de la taille requise.
Pour plus d’informations, consultez Obtention d’un nom d’interface d’appareil.
Configuration requise
Plateforme cible |
Desktop (Expérience utilisateur) |
En-tête |
Mmddk.h (inclure Mmddk.h) |