MFCreateDeviceSourceActivate-Funktion (mfidl.h)

  • Artikel

Erstellt ein Aktivierungsobjekt, das ein Hardwareerfassungsgerät darstellt.

Syntax

HRESULT MFCreateDeviceSourceActivate(
  [in]  IMFAttributes *pAttributes,
  [out] IMFActivate   **ppActivate
);

Parameter

[in] pAttributes

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

[out] ppActivate

Empfängt einen Zeiger auf die IMFActivate-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Keine

Bemerkungen

Diese Funktion erstellt ein Aktivierungsobjekt, das zum Erstellen einer Medienquelle für ein Hardwaregerät verwendet werden kann. Um die Medienquelle selbst zu erstellen, rufen Sie IMFActivate::ActivateObject auf.

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 Audioerfassungsgerä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 Standard-Audioerfassungsgerät 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 Audioaufzeichnung für die Rolle eCommunications aus.

Für Videoaufzeichnungsgerä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

Aktivierungsobjekte

Audio-/Videoaufnahme in Media Foundation

Erfassen von Geräteattributen

MFCreateDeviceSource

Media Foundation-Funktionen