funzione acmFormatSuggest (msacm.h)
La funzione acmFormatSuggest esegue una query sul driver ACM o un driver ACM specificato per suggerire un formato di destinazione per il formato di origine fornito. Ad esempio, un'applicazione può usare questa funzione per determinare uno o più formati PCM validi a cui può essere decompresso un formato compresso.
Sintassi
MMRESULT ACMAPI acmFormatSuggest(
HACMDRIVER had,
LPWAVEFORMATEX pwfxSrc,
LPWAVEFORMATEX pwfxDst,
DWORD cbwfxDst,
DWORD fdwSuggest
);
Parametri
had
Gestire un'istanza aperta di un driver per eseguire una query per un formato di destinazione suggerito. Se questo parametro è NULL, ACM tenta di trovare il driver migliore per suggerire un formato di destinazione.
pwfxSrc
Puntatore a una struttura WAVEFORMATEX che identifica il formato di origine per cui verrà suggerito un formato di destinazione dal driver ACM o specificato.
pwfxDst
Puntatore a una struttura WAVEFORMATEX che riceverà il formato di destinazione suggerito per il formato pwfxSrc . A seconda del parametro fdwSuggest , alcuni membri della struttura puntati da pwfxDst possono richiedere l'inizializzazione.
cbwfxDst
Dimensioni, in byte, disponibili per il formato di destinazione. Le funzioni acmMetrics e acmFormatTagDetails possono essere usate per determinare le dimensioni massime necessarie per qualsiasi formato disponibile per il driver specificato (o per tutti i driver ACM installati).
fdwSuggest
Flag per la corrispondenza del formato di destinazione desiderato. I valori seguenti sono definiti.
| Valore | Significato |
|---|---|
| ACM_FORMATSUGGESTF_NCHANNELS | Il membro nChannels della struttura a cui punta pwfxDst è valido. ACM eseguirà una query sui driver installati accettabili che possono suggerire un formato di destinazione corrispondente a nChannels o non riuscito. |
| ACM_FORMATSUGGESTF_NSAMPLESPERSEC | Il membro nSamplesPerSec della struttura a cui punta pwfxDst è valido. ACM eseguirà una query sui driver installati accettabili che possono suggerire un formato di destinazione corrispondente a nSamplesPerSec o non riuscito. |
| ACM_FORMATSUGGESTF_WBITSPERSAMPLE | Il membro wBitsPerSample della struttura a cui punta pwfxDst è valido. ACM eseguirà una query su driver installati accettabili che possono suggerire un formato di destinazione corrispondente a wBitsPerSample o non riuscito. |
| ACM_FORMATSUGGESTF_WFORMATTAG | Il membro wFormatTag della struttura a cui punta pwfxDst è valido. ACM eseguirà una query su driver installati accettabili che possono suggerire un formato di destinazione corrispondente a wFormatTag o non riuscito. |
Valore restituito
Restituisce zero se ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
Almeno un flag non è valido. |
|
L'handle specificato non è valido. |
|
Almeno un parametro non è valido. |
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | msacm.h |
| Libreria | Msacm32.lib |
| DLL | Msacm32.dll |