Método IKsDataTypeCompletion::KsCompleteMediaType (ksproxy.h)

  • Artículo

El método KsCompleteMediaType completa un tipo de medio especificado parcialmente que se presentó por primera vez al método IAMStreamConfig::SetFormat .

Sintaxis

HRESULT KsCompleteMediaType(
  [in]      HANDLE        FilterHandle,
  [in]      ULONG         PinFactoryId,
  [in, out] AM_MEDIA_TYPE *AmMediaType
);

Parámetros

[in] FilterHandle

Identificador del filtro KS subyacente.

[in] PinFactoryId

Identificador del generador de patillas en el que se está completando el tipo de medio.

[in, out] AmMediaType

Puntero a una estructura de AM_MEDIA_TYPE que describe el formato de los ejemplos multimedia. KsCompleteMediaType recibe muestras de medios parcialmente especificadas, completa la especificación y devuelve.

Valor devuelto

Devuelve NOERROR si se realizó correctamente y el tipo de medio se completó; de lo contrario, devuelve un código de error.

Comentarios

El método KsCompleteMediaType se usa principalmente para los tipos de medios de vídeo, en los que el miembro biSizeImage de la estructura KS_BITMAPINFOHEADER solo se conoce al controlador, debido a los formatos de compresión privados admitidos. Si es necesario, el controlador de tipos de datos puede consultar el filtro KS subyacente para completar el tipo de medio especificado.

Cuando el proxy crea una instancia del controlador de tipos de datos para completar un tipo de medio, el proxy pasa el tipo de medio al método IKsDataTypeHandler::KsSetMediaType para inicializar primero este controlador de tipo de datos al tipo de medio determinado.

Para obtener más información sobre IAMStreamConfig::SetFormat y AM_MEDIA_TYPE, consulte la documentación de Microsoft Windows SDK.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado ksproxy.h (incluya Ksproxy.h)

Consulte también

IKsDataTypeHandler::KsSetMediaType

KS_BITMAPINFOHEADER