MFCreateDeviceSource-Funktion (mfidl.h)

  • Artikel

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