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