funzione MFInitVideoFormat_RGB (mfapi.h)

Articolo
02/28/2024

[Questa API non è supportata e potrebbe essere modificata o non disponibile in futuro. Le applicazioni devono evitare di usare la struttura MFVIDEOFORMAT e usare invece gli attributi del tipo di supporto. Per altre informazioni, vedere Tipi di supporti video.]

Inizializza una struttura MFVIDEOFORMAT per un formato video RGB non compresso.

Sintassi

HRESULT MFInitVideoFormat_RGB(
  [in] MFVIDEOFORMAT *pVideoFormat,
  [in] DWORD         dwWidth,
  [in] DWORD         dwHeight,
  [in] DWORD         D3Dfmt
);

Parametri

[in] pVideoFormat

Puntatore a una struttura MFVIDEOFORMAT . Le funzioni compilano i membri della struttura con le informazioni sul formato.

[in] dwWidth

Larghezza del video, in pixel.

[in] dwHeight

Altezza del video, in pixel.

[in] D3Dfmt

Valore D3DFORMAT che specifica il formato RGB.

Valore restituito

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

Commenti

Questa funzione inserisce alcuni valori predefiniti ragionevoli per il formato RGB specificato.

Gli sviluppatori sono invitati a usare gli attributi del tipo di supporto anziché usare la struttura MFVIDEOFORMAT . Vedere Attributi del tipo di supporto.

In generale, è consigliabile evitare di chiamare questa funzione. Se conosci tutti i dettagli del formato, puoi compilare la struttura MFVIDEOFORMAT senza questa funzione. Se non si conoscono tutti i dettagli del formato, gli attributi sono preferibili all'uso della struttura MFVIDEOFORMAT .

Nota Prima di Windows 7, questa funzione è stata esportata da evr.dll. A partire da Windows 7, questa funzione viene esportata da mfplat.dll e evr.dll esporta una funzione stub che chiama in mfplat.dll. Per altre informazioni, vedere Modifiche alla libreria in Windows 7.

Requisiti

Requisito	Valore
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	Evr.lib
DLL	Mfplat.dll

Vedi anche

Funzioni di Media Foundation

Tipi di supporti

Tipi di supporti video non compressi

Tipi di supporti video

Condividi tramite