mixerGetDevCaps-Funktion (mmeapi.h)
Die mixerGetDevCaps-Funktion fragt ein angegebenes Mixergerät ab, um dessen Funktionen zu bestimmen.
Syntax
MMRESULT mixerGetDevCaps(
UINT uMxId,
LPMIXERCAPS pmxcaps,
UINT cbmxcaps
);
Parameter
uMxId
Bezeichner oder Handle eines offenen Mixergeräts.
pmxcaps
Zeiger auf eine MIXERCAPS-Struktur , die Informationen zu den Funktionen des Geräts empfängt.
cbmxcaps
Größe der MIXERCAPS-Struktur in Byte.
Rückgabewert
Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der angegebene Gerätebezeichner liegt außerhalb des Bereichs. |
|
Das Mixer-Gerätehandle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
Hinweise
Verwenden Sie die mixerGetNumDevs-Funktion , um die Anzahl der im System vorhandenen Mixergeräte zu bestimmen. Der durch uMxId angegebene Gerätebezeichner variiert von null bis 1 kleiner als die Anzahl der vorhandenen Mixergeräte.
Nur die Anzahl von Bytes (oder weniger) der in cbmxcaps angegebenen Informationen wird an den Speicherort kopiert, auf den pmxcaps verweist. Wenn cbmxcaps null ist, wird nichts kopiert, und die Funktion gibt erfolgreich zurück.
Diese Funktion akzeptiert auch einen Mixer-Gerätehandle, der von der mixerOpen-Funktion als uMxId-Parameter zurückgegeben wird. Die Anwendung sollte das HMIXER-Handle in einen UINT umwandeln.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mmeapi.h (Einschließen von Windows.h) |
| Bibliothek | Winmm.lib |
| DLL | Winmm.dll |