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 na qual o tipo de mídia está sendo concluído.
[in, out] AmMediaType
Ponteiro para uma estrutura 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.
Retornar valor
Retorna NOERROR se tiver êxito e o tipo de mídia tiver sido concluído; caso contrário, retorna um código de erro.
Comentários
O método KsCompleteMediaType é usado principalmente para tipos de mídia de vídeo, nos quais o membro biSizeImage 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 |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ksproxy.h (inclua Ksproxy.h) |