MFInitVideoFormat_RGB-Funktion (mfapi.h)

  • Artikel

[Diese API wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein. Anwendungen sollten die Verwendung der MFVIDEOFORMAT-Struktur vermeiden und stattdessen Medientypattribute verwenden. Weitere Informationen finden Sie unter Videomedientypen.]

Initialisiert eine MFVIDEOFORMAT-Struktur für ein nicht komprimiertes RGB-Videoformat.

Syntax

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

Parameter

[in] pVideoFormat

Ein Zeiger auf eine MFVIDEOFORMAT-Struktur . Die Funktionen füllen die Strukturmember mit den Formatinformationen aus.

[in] dwWidth

Die Breite des Videos in Pixel.

[in] dwHeight

Die Höhe des Videos in Pixel.

[in] D3Dfmt

Ein D3DFORMAT Wert, der das RGB-Format angibt.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion füllt einige vernünftige Standardwerte für das angegebene RGB-Format aus.

Entwickler werden empfohlen, Medientypattribute anstelle der MFVIDEOFORMAT-Struktur zu verwenden. Weitere Informationen finden Sie unter Medientypattribute.

Im Allgemeinen sollten Sie das Aufrufen dieser Funktion vermeiden. Wenn Sie alle Formatdetails kennen, können Sie die MFVIDEOFORMAT-Struktur ohne diese Funktion ausfüllen. Wenn Sie nicht alle Formatdetails kennen, sind Attribute der Verwendung der MFVIDEOFORMAT-Struktur vorzuziehen.

Hinweis Vor Windows 7 wurde diese Funktion aus evr.dll exportiert. Ab Windows 7 wird diese Funktion aus mfplat.dll exportiert, und evr.dll exportiert eine Stubfunktion, die in mfplat.dll aufruft. Weitere Informationen finden Sie unter Bibliotheksänderungen in Windows 7.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Evr.lib
DLL Mfplat.dll

Weitere Informationen

Media Foundation-Funktionen

Medientypen

Nicht komprimierte Videomedientypen

Videomedientypen