Compartilhar via


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

O método KsCompleteMediaType conclui um tipo de mídia parcialmente especificado que foi apresentado pela primeira vez ao método IAMStreamConfig::SetFormat.

Sintaxe

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

Parâmetros

[in] FilterHandle

Manipule para o filtro KS subjacente.

[in] PinFactoryId

Identificador da fábrica de pinos no qual o tipo de mídia está sendo concluído.

[in, out] AmMediaType

Ponteiro para uma estrutura de AM_MEDIA_TYPE que descreve o formato dos exemplos de mídia. KsCompleteMediaType recebe amostras de mídia parcialmente especificadas, conclui a especificação e retorna.

Valor de retorno

Retorna NOERROR se bem-sucedido e o tipo de mídia foi concluído; caso contrário, retorna um código de erro.

Observações

O método KsCompleteMediaType é usado principalmente para tipos de mídia de vídeo, no qual o biSizeImage membro da estrutura KS_BITMAPINFOHEADER é conhecido apenas pelo driver, devido aos formatos de compactação privados com suporte. Se necessário, o manipulador de tipo de dados pode consultar o filtro KS subjacente para concluir o tipo de mídia fornecido.

Quando o proxy cria uma instância do manipulador de tipo de dados para fins de conclusão de um tipo de mídia, o proxy passa o tipo de mídia para o método IKsDataTypeHandler::KsSetMediaType para inicializar primeiro esse manipulador de tipo de dados para o tipo de mídia específico.

Para obter mais informações sobre IAMStreamConfig::SetFormat e AM_MEDIA_TYPE, consulte a documentação do SDK do Microsoft Windows.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho ksproxy.h (inclua Ksproxy.h)

Consulte também

IKsDataTypeHandler::KsSetMediaType

KS_BITMAPINFOHEADER