acmFormatSuggest-Funktion (msacm.h)

Artikel
08/24/2023

Die acmFormatSuggest-Funktion fragt den ACM oder einen angegebenen ACM-Treiber ab, um ein Zielformat für das angegebene Quellformat vorzuschlagen. Beispielsweise kann eine Anwendung diese Funktion verwenden, um ein oder mehrere gültige PCM-Formate zu bestimmen, in die ein komprimiertes Format dekomprimiert werden kann.

Syntax

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

Parameter

had

Handle für eine geöffnete instance eines Treibers, um ein vorgeschlagenes Zielformat abzufragen. Wenn dieser Parameter NULL ist, versucht der ACM, den besten Treiber zu finden, um ein Zielformat vorzuschlagen.

pwfxSrc

Zeiger auf eine WAVEFORMATEX-Struktur , die das Quellformat identifiziert, für das ein Zielformat vom ACM oder dem angegebenen Treiber vorgeschlagen wird.

pwfxDst

Zeiger auf eine WAVEFORMATEX-Struktur , die das vorgeschlagene Zielformat für das pwfxSrc-Format empfängt. Abhängig vom fdwSuggest-Parameter erfordern einige Member der Struktur, auf die pwfxDst verweist, möglicherweise eine Initialisierung.

cbwfxDst

Größe in Bytes, verfügbar für das Zielformat. Die Funktionen acmMetrics und acmFormatTagDetails können verwendet werden, um die maximale Größe zu bestimmen, die für jedes Format erforderlich ist, das für den angegebenen Treiber (oder für alle installierten ACM-Treiber) verfügbar ist.

fdwSuggest

Flags zum Abgleich des gewünschten Zielformats. Die folgenden Werte werden definiert.

Wert	Bedeutung
ACM_FORMATSUGGESTF_NCHANNELS	Das nChannels-Element der Struktur, auf die pwfxDst verweist, ist gültig. Der ACM fragt akzeptable installierte Treiber ab, die ein Zielformat vorschlagen können, das nChannels entspricht, oder schlägt fehl.
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	Der nSamplesPerSec-Member der Struktur, auf die pwfxDst verweist, ist gültig. Der ACM fragt zulässige installierte Treiber ab, die ein Zielformat vorschlagen können, das nSamplesPerSec entspricht, oder schlägt fehl.
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	Das wBitsPerSample-Element der Struktur, auf die pwfxDst verweist, ist gültig. Der ACM fragt zulässige installierte Treiber ab, die ein Zielformat vorschlagen können, das mit wBitsPerSample übereinstimmt, oder schlägt fehl.
ACM_FORMATSUGGESTF_WFORMATTAG	Der wFormatTag-Member der Struktur, auf die pwfxDst verweist, ist gültig. Der ACM fragt akzeptable installierte Treiber ab, die ein Zielformat vorschlagen können, das mit wFormatTag übereinstimmt, oder schlägt fehl.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
MMSYSERR_INVALFLAG	Mindestens ein Flag ist ungültig.
MMSYSERR_INVALHANDLE	Das angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM	Mindestens ein Parameter ist ungültig.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msacm.h
Bibliothek	Msacm32.lib
DLL	Msacm32.dll

Weitere Informationen

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager