IAMPluginControl::SetPreferredClsid-Methode (strmif.h)
[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.]
Fügt der bevorzugten Liste einen Klassenbezeichner (CLSID) hinzu oder entfernt eine CLSID aus der Liste.
Syntax
HRESULT SetPreferredClsid(
[in] REFGUID subType,
[in] const CLSID *clsid
);
Parameter
[in] subType
Eine Medienuntertyp-GUID, die der CLSID zugeordnet werden soll.
[in] clsid
Zeiger auf die CLSID, die der Liste hinzugefügt werden soll. Wenn dieser Parameter NULL ist, wird der eintrag, der subType zugeordnet ist, aus der Liste entfernt.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |