mixerGetDevCapsW-Funktion (mmeapi.h)
Die mixerGetDevCaps-Funktion fragt ein angegebenes Mixergerät ab, um dessen Funktionen zu ermitteln.
Syntax
MMRESULT mixerGetDevCapsW(
UINT_PTR uMxId,
LPMIXERCAPSW pmxcaps,
UINT cbmxcaps
);
Parameter
uMxId
Bezeichner oder Handle eines geöffneten 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 Bytes.
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. |
|
Der Mischergerä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 ermitteln. Der durch uMxId angegebene Gerätebezeichner variiert von null bis eins 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 wird erfolgreich zurückgegeben.
Diese Funktion akzeptiert auch einen Von der mixerOpen-Funktion zurückgegebenen Mixergerätehandle als uMxId-Parameter . Die Anwendung sollte das HMIXER-Handle in ein UINT umwandeln.
Hinweis
Der mmeapi.h-Header definiert mixerGetDevCaps als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
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ßlich Windows.h) |
Bibliothek | Winmm.lib |
DLL | Winmm.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für