Metodo IWICBitmapEncoder::CreateNewFrame (wincodec.h)

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.

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

Vedi anche

Panoramica della codifica

IPropertyBag2

IWICBitmapEncoder