Freigeben über


acmFormatSuggest-Funktion (msacm.h)

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