IKsInterfaceHandler::KsCompleteIo-Methode (ksproxy.h)
Die KsCompleteIo-Methode bereinigt erweiterte Header und gibt Medienbeispiele nach Abschluss der Eingabe und Ausgabe (E/A) frei.
Syntax
HRESULT KsCompleteIo(
[in, out] PKSSTREAM_SEGMENT StreamSegment
);
Parameter
[in, out] StreamSegment
Zeiger auf eine KSSTREAM_SEGMENT-Struktur , die Headerinformationen für ein Datenstromsegment enthält.
Rückgabewert
Gibt NOERROR zurück, wenn dies erfolgreich war. Gibt andernfalls einen Fehlercode zurück.
Hinweise
Die KsCompleteIo-Methode verwirft den zugewiesenen Arbeitsspeicher, aktualisiert Medienbeispiele und verringert die Anzahl der Warteelemente für den Proxy.
Die KsCompleteIo-Methode muss den Typ des E/A-Vorgangs bestimmen, den die IKsInterfaceHandler::KsProcessMediaSamples-Methode aus dem IoOperation-Member der KSSTREAM_SEGMENT-Struktur abgeschlossen hat. Wenn der E/A-Vorgang Daten aus einem Stream (KsIoOperation_Read des aufgezählten KSIOOPERATION-Typs) gelesen hat, führt KsCompleteIo die folgenden Aktionen aus, um das Beispiel von einem Ausgabepin an den verbundenen Eingabenadel zu übermitteln:
- Gibt die Datenstromheaderinformationen in der IMediaSample-Schnittstelle wieder.
- Ruft die IKsPin::KsDeliver-Methode des Ausgabepins auf, um das Beispiel zu übermitteln. KsDeliver gibt das Beispiel frei, sodass beim Anstehen von Puffern für das Gerät das Beispiel abgerufen werden kann, wenn es sich um das letzte Beispiel handelt. Der Eingabenadel schließt dann die E/A-Vorgänge ab, und das Beispiel kann sicher freigegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ksproxy.h (include Ksproxy.h) |