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 |
|---|---|
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
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 |