Freigeben über


CSourceSeeking.QueryPreferredFormat-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die QueryPreferredFormat -Methode ruft das bevorzugte Zeitformat des Objekts ab. Diese Methode implementiert die IMediaSeeking::QueryPreferredFormat-Methode .

Syntax

HRESULT QueryPreferredFormat(
   GUID *pFormat
);

Parameter

pFormat

Zeiger auf eine Variable, die eine Zeitformat-GUID empfängt. Weitere Informationen finden Sie unter GUIDs für das Zeitformat.

Rückgabewert

Gibt einen der in der folgenden Tabelle aufgeführten HRESULT-Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Erfolgreich
E_POINTER
NULL-Zeigerwert

Bemerkungen

Das einzige von der Basisklasse unterstützte Zeitformat ist TIME_FORMAT_MEDIA_TIME (100 Nanosekundeneinheiten).

Anforderungen

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

Siehe auch

CSourceSeeking-Klasse