Funzione GetMetaFileBitsEx (wingdi.h)

Articolo
03/04/2024

La funzione GetMetaFileBitsEx recupera il contenuto di un metafile in formato Windows e li copia nel buffer specificato.

Nota Questa funzione viene fornita solo per la compatibilità con i metafile in formato Windows. I metafile in formato avanzato offrono funzionalità superiori e sono consigliati per le nuove applicazioni. La funzione corrispondente per un metafile in formato avanzato è GetEnhMetaFileBits.

Sintassi

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

Parametri

[in] hMF

Handle per un metafile in formato Windows.

[in] cbBuffer

Dimensione, in byte, del buffer per ricevere i dati.

[out] lpData

Puntatore a un buffer che riceve i dati del metafile. Il buffer deve essere sufficientemente grande per contenere i dati. Se lpvData è NULL, la funzione restituisce il numero di byte necessari per contenere i dati.

Valore restituito

Se la funzione ha esito positivo e il puntatore del buffer è NULL, il valore restituito è il numero di byte necessari per il buffer; se la funzione ha esito positivo e il puntatore del buffer è un puntatore valido, il valore restituito è il numero di byte copiati.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Dopo aver recuperato i bit metafile di Windows, possono essere usati per creare un metafile basato sulla memoria chiamando la funzione SetMetaFileBitsEx .

La funzione GetMetaFileBitsEx non invalida l'handle metafile. Un'applicazione deve eliminare questo handle chiamando la funzione DeleteMetaFile .

Per convertire un metafile in formato Windows in un metafile in formato avanzato, usare la funzione SetWinMetaFileBits .

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	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll