Structure WAVEOUTCAPSW (mmeapi.h)
La structure WAVEOUTCAPS décrit les fonctionnalités d’un périphérique de sortie audio de forme d’onde.
Syntaxe
typedef struct tagWAVEOUTCAPSW {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
WCHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
DWORD dwSupport;
} WAVEOUTCAPSW, *PWAVEOUTCAPSW, *NPWAVEOUTCAPSW, *LPWAVEOUTCAPSW;
Membres
wMid
Identificateur du fabricant du pilote de périphérique pour l’appareil. Les identificateurs de fabricant sont définis dans Identificateurs de fabricant et de produit.
wPid
Identificateur de produit pour l’appareil. Les identificateurs de produit sont définis dans Identificateurs de fabricant et de produit.
vDriverVersion
Numéro de version du pilote de périphérique pour l’appareil. L’octet d’ordre élevé est le numéro de version principale, et l’octet d’ordre inférieur est le numéro de version secondaire.
szPname[MAXPNAMELEN]
Nom du produit dans une chaîne terminée par null.
dwFormats
Formats standard pris en charge. Il peut s’agir d’une combinaison des éléments suivants :
| Format | Description |
|---|---|
| WAVE_FORMAT_1M08 | 11,025 kHz, mono, 8 bits |
| WAVE_FORMAT_1M16 | 11,025 kHz, mono, 16 bits |
| WAVE_FORMAT_1S08 | 11,025 kHz, stéréo, 8 bits |
| WAVE_FORMAT_1S16 | 11,025 kHz, stéréo, 16 bits |
| WAVE_FORMAT_2M08 | 22,05 kHz, mono, 8 bits |
| WAVE_FORMAT_2M16 | 22,05 kHz, mono, 16 bits |
| WAVE_FORMAT_2S08 | 22,05 kHz, stéréo, 8 bits |
| WAVE_FORMAT_2S16 | 22,05 kHz, stéréo, 16 bits |
| WAVE_FORMAT_4M08 | 44,1 kHz, mono, 8 bits |
| WAVE_FORMAT_4M16 | 44,1 kHz, mono, 16 bits |
| WAVE_FORMAT_4S08 | 44,1 kHz, stéréo, 8 bits |
| WAVE_FORMAT_4S16 | 44,1 kHz, stéréo, 16 bits |
| WAVE_FORMAT_96M08 | 96 kHz, mono, 8 bits |
| WAVE_FORMAT_96M16 | 96 kHz, mono, 16 bits |
| WAVE_FORMAT_96S08 | 96 kHz, stéréo, 8 bits |
| WAVE_FORMAT_96S16 | 96 kHz, stéréo, 16 bits |
wChannels
Nombre spécifiant si l’appareil prend en charge la sortie mono (1) ou stéréo (2).
wReserved1
dwSupport
Fonctionnalité facultative prise en charge par l’appareil. Les valeurs suivantes sont définies :
| Indicateur | Description |
|---|---|
| WAVECAPS_LRVOLUME | Prend en charge le contrôle de volume gauche et droit distinct. |
| WAVECAPS_PITCH | Prend en charge le contrôle d’inclinaison. |
| WAVECAPS_PLAYBACKRATE | Prend en charge le contrôle de la vitesse de lecture. |
| WAVECAPS_SYNC | Le pilote est synchrone et se bloque lors de la lecture d’une mémoire tampon. |
| WAVECAPS_VOLUME | Prend en charge le contrôle de volume. |
| WAVECAPS_SAMPLEACCURATE | Retourne des informations de position précises sur l’échantillon. |
Remarques
Si un appareil prend en charge les modifications de volume, l’indicateur WAVECAPS_VOLUME est défini pour le membre dwSupport . Si un appareil prend en charge des modifications de volume distinctes sur les canaux gauche et droit, les indicateurs WAVECAPS_VOLUME et WAVECAPS_LRVOLUME sont définis pour ce membre.
Notes
L’en-tête mmeapi.h définit WAVEOUTCAPS en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | mmeapi.h (inclure Windows.h) |