funzione acmStreamSize (msacm.h)

La funzione acmStreamSize restituisce una dimensione consigliata per un buffer di origine o di destinazione in un flusso ACM.

Sintassi

MMRESULT ACMAPI acmStreamSize(
  HACMSTREAM has,
  DWORD      cbInput,
  LPDWORD    pdwOutputBytes,
  DWORD      fdwSize
);

Parametri

has

Gestire il flusso di conversione.

cbInput

Dimensioni, in byte, del buffer di origine o di destinazione. I flag fdwSize specificano il parametro di input definito. Questo parametro deve essere diverso da zero.

pdwOutputBytes

Puntatore a una variabile contenente le dimensioni, in byte, del buffer di origine o di destinazione. I flag fdwSize specificano il parametro di output definito. Se la funzione acmStreamSize ha esito positivo, questa posizione verrà sempre riempita con un valore diverso da zero.

fdwSize

Flag per la query delle dimensioni del flusso. I valori seguenti sono definiti:

Valore	Significato
ACM_STREAMSIZEF_DESTINATION	Il parametro cbInput contiene le dimensioni del buffer di destinazione. Il parametro pdwOutputBytes riceverà le dimensioni consigliate del buffer di origine, in byte.
ACM_STREAMSIZEF_SOURCE	Il parametro cbInput contiene le dimensioni del buffer di origine. Il parametro pdwOutputBytes riceverà le dimensioni del buffer di destinazione consigliate, in byte.

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
ACMERR_NOTPOSSIBLE	Impossibile eseguire l'operazione richiesta.
MMSYSERR_INVALFLAG	Almeno un flag non è valido.
MMSYSERR_INVALHANDLE	L'handle specificato non è valido.
MMSYSERR_INVALPARAM	Almeno un parametro non è valido.

Commenti

Un'applicazione può usare questa funzione per determinare le dimensioni del buffer suggerite per i buffer di origine o di destinazione. Le dimensioni del buffer restituite potrebbero essere solo una stima delle dimensioni effettive necessarie per la conversione. Poiché le dimensioni effettive delle conversioni non possono sempre essere determinate senza eseguire la conversione, le dimensioni restituite in genere verranno sovrastimate.

In caso di errore, la posizione puntata da pdwOutputBytes riceverà zero. Ciò presuppone che il puntatore specificato da pdwOutputBytes sia valido.

Requisiti

Requisito	Valore
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

Vedi anche

Funzioni di compressione audio

Gestione compressione audio