IKsDataTypeCompletion::KsCompleteMediaType-Methode (ksproxy.h)

Die KsCompleteMediaType-Methode schließt einen teilweise angegebenen Medientyp ab, der zuerst der IAMStreamConfig::SetFormat-Methode angezeigt wurde.

Syntax

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

Parameter

[in] FilterHandle

Handle für den zugrunde liegenden KS-Filter.

[in] PinFactoryId

Bezeichner der Pinfactory, für die der Medientyp abgeschlossen wird.

[in, out] AmMediaType

Zeiger auf eine AM_MEDIA_TYPE Struktur, die das Format der Medienbeispiele beschreibt. KsCompleteMediaType empfängt teilweise angegebene Medienbeispiele, vervollständigt die Spezifikation und gibt zurück.

Rückgabewert

Gibt NOERROR zurück, wenn erfolgreich und der Medientyp abgeschlossen wurde; Gibt andernfalls einen Fehlercode zurück.

Hinweise

Die KsCompleteMediaType-Methode wird hauptsächlich für Videomedientypen verwendet, bei denen der biSizeImage-Member der KS_BITMAPINFOHEADER-Struktur aufgrund der unterstützten privaten Komprimierungsformate nur dem Treiber bekannt ist. Bei Bedarf kann der Datentyphandler den zugrunde liegenden KS-Filter abfragen, um den angegebenen Medientyp zu vervollständigen.

Wenn der Proxy eine instance des Datentyphandlers zum Abschließen eines Medientyps erstellt, übergibt der Proxy den Medientyp an die IKsDataTypeHandler::KsSetMediaType-Methode, um diesen Datentyphandler zuerst für den jeweiligen Medientyp zu initialisieren.

Weitere Informationen zu IAMStreamConfig::SetFormat und AM_MEDIA_TYPE finden Sie in der Microsoft Windows SDK-Dokumentation.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	ksproxy.h (include Ksproxy.h)

Weitere Informationen

IKsDataTypeHandler::KsSetMediaType

KS_BITMAPINFOHEADER