Metodo IWICBitmapEncoder::CreateNewFrame (wincodec.h)

Articolo
03/03/2024

Crea una nuova istanza di IWICBitmapFrameEncode .

Sintassi

HRESULT CreateNewFrame(
  [out]     IWICBitmapFrameEncode **ppIFrameEncode,
  [in, out] IPropertyBag2         **ppIEncoderOptions
);

Parametri

[out] ppIFrameEncode

Tipo: IWICBitmapFrameEncode**

Puntatore che riceve un puntatore alla nuova istanza di un oggetto IWICBitmapFrameEncode.

[in, out] ppIEncoderOptions

Tipo: IPropertyBag2**

facoltativo. Riceve le proprietà denominate da usare per l'inizializzazione del frame successiva. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il parametro ppIEncoderOptions può essere usato per ricevere un oggetto IPropertyBag2 che può quindi essere usato per specificare le opzioni del codificatore. Questa operazione viene eseguita passando un puntatore a un puntatore NULL IPropertyBag2 in ppIEncoderOptions. Il valore IPropertyBag2 restituito viene inizializzato con tutte le opzioni del codificatore disponibili per il formato specificato, in corrispondenza dei valori predefiniti. Per specificare il comportamento di codifica non predefinito, impostare le opzioni del codificatore necessarie su IPropertyBag2 e passarlo a IWICBitmapFrameEncode::Initialize.

Nota Non passare un puntatore a un IPropertyBag2 inizializzato. Il puntatore verrà sovrascritto e l'originale IPropertyBag2 non verrà liberato.

In caso contrario, è possibile passare NULL in ppIEncoderOptions se non si intende specificare le opzioni del codificatore.

Vedere Panoramica della codifica per un esempio di come impostare le opzioni del codificatore.

Per i formati che supportano la codifica di più fotogrammi,ad esempio TIFF, JPEG-XR, è possibile lavorare su un solo frame alla volta. Ciò significa che è necessario chiamare IWICBitmapFrameEncode::Commit prima di chiamare di nuovo CreateNewFrame .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincodec.h
Libreria	Windowscodecs.lib
DLL	Windowscodecs.dll

Vedi anche

Panoramica della codifica

IPropertyBag2

IWICBitmapEncoder

Condividi tramite