Funzione MFCalculateBitmapImageSize (mfapi.h)

  • Articolo

Recupera le dimensioni dell'immagine per un formato video. Dato una struttura BITMAPINFOHEADER , questa funzione calcola il valore corretto del membro biSizeImage .

Sintassi

HRESULT MFCalculateBitmapImageSize(
  [in]  const BITMAPINFOHEADER *pBMIH,
  [in]  UINT32                 cbBufSize,
  [out] UINT32                 *pcbImageSize,
  [out] BOOL                   *pbKnown
);

Parametri

[in] pBMIH

Puntatore a una struttura BITMAPINFOHEADER che descrive il formato.

[in] cbBufSize

Dimensioni del buffer pBMIH , in byte. Le dimensioni includono tutte le maschere di colore o le voci della tavolozza che seguono la struttura BITMAPINFOHEADER .

[out] pcbImageSize

Riceve le dimensioni dell'immagine, in byte.

[out] pbKnown

Riceve il valore TRUE se la funzione riconosce il formato video. In caso contrario, riceve il valore FALSE. Questo parametro può essere NULL.

Valore restituito

La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
 Funzione completata.
E_INVALIDARG
 La struttura BITMAPINFOHEADER non è valida o il valore di cbBufSize è troppo piccolo.

Commenti

Prima di chiamare questa funzione, è necessario impostare almeno i membri seguenti della struttura BITMAPINFOHEADER :

  • biCompressione
  • biBitCount
  • biWidth
  • biHeight
Inoltre, se biCompression è BI_BITFIELDS, la struttura BITMAPINFOHEADER deve essere seguita da una matrice di maschere di colore.

Questa funzione ha esito negativo se la struttura BITMAPINFOHEADER descrive un formato che non è un formato video. Ad esempio, ha esito negativo se biCompresson è BI_JPEG o BI_PNG .

Questa funzione è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:

  • Windows XP con Service Pack 2 (SP2) e versioni successive.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mfapi.h
Libreria Mfplat.lib
DLL Mfplat.dll

Vedi anche

Funzioni di Media Foundation