MFCreateDeviceSourceActivate-Funktion (mfidl.h)
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 |