MFCreateDeviceSource Function
Creates a media source for a hardware capture device.
Syntax
HRESULT MFCreateDeviceSource(
__in IMFAttributes *pAttributes,
__out IMFMediaSource **ppSource
);
Parameter
pAttributes [in]
Pointer to the IMFAttributes interface of an attribute store, which is used to select the device. See Remarks.ppSource [out]
Receives a pointer to the media source's IMFMediaSource interface. The caller must release the interface.
Rückgabewert
Ist Funktion erfolgreich, wird "S_OK" zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
The pAttributes parameter specifies an attribute store. To create the attribute store, call the MFCreateAttributes function. You must set the MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE attribute, which specifies the type of device (audio or video).
For audio capture devices, optionally set one of the following attributes:
| Attribute | Beschreibung |
|---|---|
Specifies the audio endpoint ID of the audio capture device. |
|
Specifies the device role. If this attribute is set, the function uses the default audio capture device for that device role. Do not combine this attribute with the MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID attribute. |
If neither attribute is specified, the function selects the default audio capture device for the eCommunications role.
For video capture devices, you must set the following attribute:
| Attribute | Beschreibung |
|---|---|
Specifies the symbolic link to the device. |
Anforderungen
Mindestens unterstützter Client |
Windows 7 |
Mindestens unterstützter Server |
Windows Server 2008 R2 |
Header |
Mfidl.h |
Bibliothek |
Mf.lib |
DLL |
Mf.dll |