Funzione MFCreateDeviceSourceActivate (mfidl.h)
Crea un oggetto di attivazione che rappresenta un dispositivo di acquisizione hardware.
Sintassi
HRESULT MFCreateDeviceSourceActivate(
[in] IMFAttributes *pAttributes,
[out] IMFActivate **ppActivate
);
Parametri
[in] pAttributes
Puntatore all'interfaccia FMAttributes di un archivio attributi, usato per selezionare il dispositivo. Vedere la sezione Osservazioni.
[out] ppActivate
Riceve un puntatore all'interfaccia FMActivate . Il chiamante deve rilasciare l'interfaccia.
Valore restituito
nessuno
Osservazioni
Questa funzione crea un oggetto di attivazione che può essere usato per creare un'origine multimediale per un dispositivo hardware. Per creare l'origine multimediale stessa, chiamare FMActivate::ActivateObject.
Il parametro pAttributes specifica un archivio attributi. Per creare l'archivio attributi, chiamare la funzione MFCreateAttributes . È necessario impostare l'attributo MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE , che specifica il tipo di dispositivo (audio o video).
Per i dispositivi di acquisizione audio, impostare facoltativamente uno degli attributi seguenti:
| Attributo | Descrizione |
|---|---|
| MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID | Specifica l'ID dell'endpoint audio del dispositivo di acquisizione audio. |
| MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE |
Specifica il ruolo del dispositivo. Se questo attributo è impostato, la funzione usa il dispositivo di acquisizione audio predefinito per tale ruolo del dispositivo.
Non combinare questo attributo con l'attributo MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID . |
Se non viene specificato alcun attributo, la funzione seleziona il dispositivo di acquisizione audio predefinito per il ruolo eCommunications .
Per i dispositivi di acquisizione video, è necessario impostare l'attributo seguente:
| Attributo | Descrizione |
|---|---|
| MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK | Specifica il collegamento simbolico al dispositivo. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mfidl.h |
| Libreria | Mf.lib |
| DLL | Mf.dll |
Vedi anche
Acquisizione audio/video in Media Foundation