Función MFCreateDeviceSource (mfidl.h)

  • Artículo

Crea un origen multimedia para un dispositivo de captura de hardware.

Sintaxis

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

Parámetros

[in] pAttributes

Puntero a la interfaz IMFAttributes de un almacén de atributos, que se usa para seleccionar el dispositivo. Vea la sección Comentarios.

[out] ppSource

Recibe un puntero a la interfaz IMFMediaSource de la fuente multimedia. El autor de la llamada debe liberar la interfaz .

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Importante Cuando el dispositivo de captura ya no sea necesario, debe apagar el dispositivo llamando a Shutdown en el objeto IMFMediaSource que obtuvo llamando a MFCreateDeviceSource. Si no se llama a Shutdown , se pueden producir vínculos de memoria porque el sistema puede mantener una referencia a los recursos IMFMediaSource hasta que se llame a Shutdown .
 
El parámetro pAttributes especifica un almacén de atributos. Para crear el almacén de atributos, llame a la función MFCreateAttributes . Debe establecer el atributo MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE , que especifica el tipo de dispositivo (audio o vídeo).

En el caso de los dispositivos de captura de audio, establezca opcionalmente uno de los siguientes atributos:

Atributo Descripción
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID Especifica el identificador de punto de conexión de audio del dispositivo de captura de audio.
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE Especifica el rol de dispositivo. Si se establece este atributo, la función usa el dispositivo de captura de audio predeterminado para ese rol de dispositivo.

No combine este atributo con el atributo MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID .
 

Si no se especifica ninguno de los atributos, la función selecciona el dispositivo de captura de audio predeterminado para el rol eCommunications .

En el caso de los dispositivos de captura de vídeo, debe establecer el atributo siguiente:

Atributo Descripción
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK Especifica el vínculo simbólico al dispositivo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mf.lib
Archivo DLL Mf.dll

Consulte también

Captura de audio y vídeo en Media Foundation

Capturar atributos de dispositivo

MFCreateDeviceSourceActivate

Funciones de Media Foundation