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) |