Freigeben über


CImageDisplay.RefreshDisplayType-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die RefreshDisplayType -Methode aktualisiert das Videoformat des Objekts so, dass es der angegebenen Anzeige entspricht.

Syntax

HRESULT RefreshDisplayType(
   LPSTR szDeviceName
);

Parameter

szDeviceName

Zeiger auf eine Zeichenfolge, die den Namen des Anzeigegeräts enthält, wie von der GDI-Funktion EnumDisplayDevices zurückgegeben wird. Um das Standard Anzeigegerät zu verwenden, legen Sie diesen Parameter auf NULL fest.

Rückgabewert

Gibt S_OK zurück, wenn dies erfolgreich war, oder E_FAIL, wenn der Fehler nicht erfolgreich war.

Bemerkungen

Diese Methode initialisiert das m_Display Member für einen Videotyp, der dem Anzeigemodus auf dem angegebenen Gerät entspricht.

Rufen Sie diese Methode immer dann auf, wenn eine WM_DISPLAYCHANGED Nachricht empfangen wird, oder um ein sekundäres Anzeigegerät anzugeben.

Anforderungen

Anforderung Wert
Header
Winutil.h (streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CImageDisplay-Klasse