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

Confira também

IKsDataTypeHandler::KsSetMediaType

KS_BITMAPINFOHEADER