Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die auxGetDevCaps-Funktion ruft die Funktionen eines bestimmten Hilfsausgabegeräts ab.
Syntax
MMRESULT auxGetDevCapsA(
UINT_PTR uDeviceID,
LPAUXCAPSA pac,
UINT cbac
);
Parameter
uDeviceID
Bezeichner des abgefragten Hilfsausgabegeräts. Geben Sie einen gültigen Gerätebezeichner an (siehe folgenden Kommentarabschnitt), oder verwenden Sie die folgende Konstante:
| Wert | Bedeutung |
|---|---|
| AUX_MAPPER | Zusätzliche Audiozuordnung. Die Funktion gibt einen Fehler zurück, wenn keine zusätzliche Audiozuordnung installiert ist. |
pac
Zeiger auf eine AUXCAPS-Struktur , die mit Informationen über die Funktionen des Geräts gefüllt werden soll.
cbac
Größe der AUXCAPS-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. |
Hinweise
Der Gerätebezeichner in uDeviceID variiert von null bis eins kleiner als die Anzahl der vorhandenen Geräte. AUX_MAPPER können auch verwendet werden. Verwenden Sie die auxGetNumDevs-Funktion , um die Anzahl der im System vorhandenen Hilfsausgabegeräte zu ermitteln.
Hinweis
Der mmeapi.h-Header definiert auxGetDevCaps 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 |