Funzione MFCalculateBitmapImageSize (mfapi.h)

Articolo
03/15/2023

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

Condividi tramite