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

Oggetti attivazione

Acquisizione audio/video in Media Foundation

Acquisire attributi del dispositivo

MFCreateDeviceSource

Funzioni di Media Foundation