IWiaMiniDrvTransferCallback::GetNextStream-Methode (wiamindr_lh.h)

Artikel
02/07/2025

Vom WIA-Minitreiber aufgerufen, um einen Datenstrom für die aktuelle Datenübertragung (Download oder Upload) abzurufen.

Syntax

HRESULT GetNextStream(
  [in]  LONG    lFlags,
  [in]  BSTR    bstrItemName,
  [in]  BSTR    bstrFullItemName,
  [out] IStream **ppIStream
);

Parameter

[in] lFlags

Stellt Flagbits dar. Dieser Parameter ist nicht verwendet und sollte vom Aufrufer immer auf Null (0) festgelegt werden.

[in] bstrItemName

Der Name des Elements, das die Datenübertragung durchführt.

Weitere Informationen finden Sie unter WIA_IPA_ITEM_NAME.

[in] bstrFullItemName

Der vollständige Name des Elements, das die Datenübertragung durchführt.

Weitere Informationen finden Sie unter WIA_IPA_FULL_ITEM_NAME.

[out] ppIStream

Ein Zeiger auf ein IStream--Objekt.

Rückgabewert

Diese Methode gibt S_OK zurück, wenn der Aufruf erfolgreich ist. Andernfalls wird ein entsprechender HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Wenn der Client anfordert, die Datenübertragung zu überspringen, gibt die GetNextStream--Methode WIA_STATUS_SKIP_ITEMzurück. Der WIA-Minitreiber muss die aktuelle Bildübertragung überspringen und ggf. mit der nächsten Bildübertragung fortfahren. Beenden Sie z. B. bei einer Downloadübertragung das aktuelle Bild, und verwerfen Sie dann die Bilddaten.

Wenn die aktuelle Übertragungssequenz abgebrochen wird, gibt die GetNextStream--Methode S_FALSEzurück.