Freigeben über


IKsPropertySet::QuerySupported-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 QuerySupported -Methode bestimmt, ob ein Objekt einen angegebenen Eigenschaftssatz unterstützt.

Syntax

HRESULT QuerySupported(
  [in]  REFGUID guidPropSet,
  [in]  DWORD   dwPropID,
  [out] DWORD   *pTypeSupport
);

Parameter

guidPropSet [in]

GUID des Eigenschaftensatzes.

dwPropID [in]

Bezeichner der Eigenschaft innerhalb des Eigenschaftssatzes.

pTypeSupport [out]

Zeiger auf einen Wert, in dem Flags gespeichert werden sollen, die die vom Treiber bereitgestellte Unterstützung angeben. Folgende Flags werden unterstützt.

value Beschreibung
KSPROPERTY_SUPPORT_GET Sie können die -Eigenschaft abrufen, indem Sie die IKsPropertySet::Get-Methode aufrufen.
KSPROPERTY_SUPPORT_SET Sie können die Eigenschaft ändern, indem Sie IKsPropertySet::Set aufrufen.

 

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
S_OK
Die angegebene Kombination aus Eigenschaftssatz und Eigenschafts-ID wird unterstützt.
E_NOTIMPL
Der Eigenschaftssatz wird nicht unterstützt.
E_PROP_ID_UNSUPPORTED
Die Eigenschaften-ID wird für den angegebenen Eigenschaftensatz nicht unterstützt.
E_PROP_SET_UNSUPPORTED
Der Eigenschaftssatz wird nicht unterstützt.

 

Bemerkungen

Hinweis

Eine weitere Schnittstelle mit diesem Namen ist in der Headerdatei dsound.h vorhanden. Die beiden Schnittstellen sind nicht kompatibel. Die IKsControl-Schnittstelle , die im DirectShow DDK dokumentiert ist, ist jetzt die empfohlene Schnittstelle zum Übergeben von Eigenschaftssätzen zwischen WDM-Treibern und Benutzermoduskomponenten.

 

Sie müssen Ks.h vor Ksproxy.h einschließen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Ks.h;
Ksproxy.h
Bibliothek
Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IKsPropertySet-Schnittstelle

Eigenschaftensätze