DRV_QUERYDEVICEINTERFACESIZE, fonction
Le message DRV_QUERYDEVICEINTERFACESIZE interroge la taille de la mémoire tampon requise pour contenir le nom de l’interface de l’appareil.
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_QUERYDEVICEINTERFACESIZE lorsqu’il appelle xxxMessage pour traiter ce message d’appareil.dwParam1
Pointeur vers la taille de la mémoire tampon. Ce paramètre pointe vers une variable ULONG dans laquelle la fonction écrit la taille de mémoire tampon requise en octets. La taille inclut l’espace de stockage pour la valeur null de fin de la chaîne de nom. La taille est égale à zéro si l’ID d’appareil identifie un appareil qui n’a pas d’interface d’appareil.dwParam2
Inutilisé. Définissez ce paramètre sur zéro.
Valeur retournée
La fonction xxxMessage retourne MMSYSERR_NOERROR si le message est correctement géré. Sinon, elle retourne un code d’erreur approprié.
Remarques
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.
La taille de la mémoire tampon récupérée par ce message est exprimée sous la forme d’un nombre d’octets. Il spécifie la taille de la mémoire tampon nécessaire pour contenir la chaîne Unicode terminée par null qui contient le nom de l’interface de périphérique. L’appelant alloue une mémoire tampon de la taille spécifiée et utilise le message DRV_QUERYDEVICEINTERFACE pour récupérer la chaîne de nom de l’interface de périphérique.
Pour plus d’informations, consultez Obtention d’un nom d’interface d’appareil.
Configuration requise
Plateforme cible |
Desktop (Expérience utilisateur) |
Version |
Pris en charge dans Les systèmes d’exploitation Microsoft Windows Me et Windows 2000 et ultérieur. |
En-tête |
Mmddk.h (include Mmddk.h) |
Voir aussi
Obtention d’un nom d’interface d’appareil