Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
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 |