MFCreateDeviceSource-Funktion (mfidl.h)

Artikel
02/28/2024

Erstellt eine Medienquelle für ein Hardwareerfassungsgerät.

Syntax

HRESULT MFCreateDeviceSource(
  [in]  IMFAttributes  *pAttributes,
  [out] IMFMediaSource **ppSource
);

Parameter

[in] pAttributes

Zeiger auf die IMFAttributes-Schnittstelle eines Attributspeichers , der zum Auswählen des Geräts verwendet wird. Siehe Hinweise.

[out] ppSource

Empfängt einen Zeiger auf die IMFMediaSource-Schnittstelle der Medienquelle. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

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

Hinweise

Wichtig Wenn das Erfassungsgerät nicht mehr benötigt wird, müssen Sie das Gerät herunterfahren, indem Sie Shutdown für das IMFMediaSource-Objekt aufrufen, das Sie durch Aufrufen von MFCreateDeviceSource abgerufen haben. Wenn Das Herunterfahren nicht aufgerufen wird, kann dies zu Speicherverbindungen führen, da das System möglicherweise einen Verweis auf IMFMediaSource-Ressourcen behält, bis das Herunterfahren aufgerufen wird.

Der pAttributes-Parameter gibt einen Attributspeicher an. Um den Attributspeicher zu erstellen, rufen Sie die MFCreateAttributes-Funktion auf . Sie müssen das MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE-Attribut festlegen, das den Gerätetyp (Audio oder Video) angibt.

Legen Sie für Audioaufnahmegeräte optional eines der folgenden Attribute fest:

attribute	BESCHREIBUNG
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID	Gibt die Audioendpunkt-ID des Audioaufnahmegeräts an.
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE	Gibt die Geräterolle an. Wenn dieses Attribut festgelegt ist, verwendet die Funktion das Standardgerät für die Audioaufnahme für diese Geräterolle. Kombinieren Sie dieses Attribut nicht mit dem attribut MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID .

Wenn kein Attribut angegeben ist, wählt die Funktion das Standardgerät für die Audioaufnahme für die Rolle eCommunications aus.

Für Videoaufnahmegeräte müssen Sie das folgende Attribut festlegen:

attribute	BESCHREIBUNG
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK	Gibt die symbolische Verknüpfung mit dem Gerät an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mf.lib
DLL	Mf.dll

Weitere Informationen

Audio-/Videoaufnahme in Media Foundation

Erfassen von Geräteattributen

MFCreateDeviceSourceActivate

Media Foundation-Funktionen

Freigeben über