Funzione MFCreateDeviceSource (mfidl.h)

Articolo
03/05/2024

Crea un'origine multimediale per un dispositivo di acquisizione hardware.

Sintassi

HRESULT MFCreateDeviceSource(
  [in]  IMFAttributes  *pAttributes,
  [out] IMFMediaSource **ppSource
);

Parametri

[in] pAttributes

Puntatore all'interfaccia FMAttributes di un archivio attributi, usato per selezionare il dispositivo. Vedere la sezione Osservazioni.

[out] ppSource

Riceve un puntatore all'interfaccia FMMediaSource dell'origine multimediale. Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Importante Quando il dispositivo di acquisizione non è più necessario, è necessario arrestare il dispositivo chiamando Shutdown sull'oggetto IMFMediaSource ottenuto chiamando MFCreateDeviceSource. L'errore di chiamare l'arresto può causare collegamenti alla memoria perché il sistema può mantenere un riferimento alle risorse FMMediaSource fino a quando non viene chiamato l'arresto .

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

Acquisire attributi del dispositivo

MFCreateDeviceSourceActivate

Funzioni di Media Foundation

Condividi tramite