IPrintWriteStreamFlush::FlushData-Methode (filterpipeline.h)

Die FlushData-Methode leert gepufferte Daten in einen Datenstrom, während der Datenstrom geöffnet bleibt, sodass der Aufrufer zusätzliche Daten in den Datenstrom schreiben kann. Das Schreiben in den Stream erfolgt mit der IPrintWriteStream::WriteBytes-Methode .

Syntax

HRESULT FlushData();

Rückgabewert

Die FlushData-Methode gibt einen HRESULT-Wert zurück.

Hinweise

Nur der letzte Filter in der Druckfilterpipeline profitiert von der Leerung. Die Daten werden in den Portmonitor geleert. Der Portmonitor hat jedoch die Möglichkeit, Puffer zu verwenden.

Beispiele

Der folgende Codeausschnitt zeigt, wie Daten in einen Datenstrom geleert werden. Beachten Sie, dass die Fehlerüberprüfung aus Gründen der Übersichtlichkeit ausgelassen wurde.

// Flushing data to a data stream
// ------------------------------
// Declare a pointer to an IPrintWriteStreamFlush interface
IPrintWriteStreamFlush *pIFlush;

// Retrieve a pointer to an IPrintWriteStream interface
// by using the RequestWriter() method in InitializeFilter()
IPrintWriteStream      *pIWrite;

HRESULT hr = pIWrite->QueryInterface(IID_IPrintWriteStreamFlush, reinterpret_cast<void **>(&pIFlush));

hr = pIWrite->WriteBytes(buf, cb, &cbWritten);

hr = pIFlush->FlushData();

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile filterpipeline.h

Weitere Informationen

IPrintWriteStream::WriteBytes

IPrintWriteStreamFlush