Obtention d’un nom d’interface d’appareil
Dans Windows Me et Windows 2000 et versions ultérieures, les fonctions multimédias Windows waveInMessage, waveOutMessage, midiInMessage, midiOutMessage et mixerMessage peuvent récupérer le nom d’interface d’appareil d’un appareil. Ces informations sont utiles pour les programmes d’application qui doivent identifier l’appareil en dehors de l’API waveIn, waveOut, midiIn, midiOut ou mixer. Dans l’une de ces API, un ID d’appareil est suffisant.
Le gestionnaire de Plug-and-Play génère un nom d’interface d’appareil pour identifier de manière unique chaque appareil qu’il énumère. Une application doit traiter la chaîne contenant un nom d’interface d’appareil comme opaque. Pour plus d’informations sur les interfaces d’appareil, consultez Présentation des interfaces d’appareil.
Le fichier d’en-tête Mmddk.h définit deux constantes de message dans le but d’obtenir des noms d’interface d’appareil :
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.
Le système intercepte et gère les messages DRV_QUERYDEVICEINTERFACESIZE et DRV_QUERYDEVICEINTERFACE sans envoyer les messages au pilote de périphérique.
Le premier paramètre de la fonction xxxMessage est l’ID de l’appareil, que l’appelant doit convertir en type de handle approprié : HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT ou HMIXER. Pour plus d’informations sur les fonctions xxxMessage, consultez Messages d’appareil interceptés par le système.