Condividi tramite


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