Condividi tramite


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