IWiaMiniDrvTransferCallback::GetNextStream-Methode (wiamindr_lh.h)

Artikel
02/27/2024

Wird vom WIA-Minitreiber aufgerufen, um einen Stream 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 wird 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 geeigneter HRESULT-Fehlercode zurückgegeben.

Hinweise

Wenn der Client anfordert, die Datenübertragung zu überspringen, gibt die GetNextStream-MethodeWIA_STATUS_SKIP_ITEM zurück. Der WIA-Minitreiber muss die aktuelle Bildübertragung überspringen und ggf. mit der nächsten Bildübertragung fortfahren. Schließen Sie beispielsweise für eine Downloadübertragung die Überprüfung des aktuellen Bilds ab, und verwerfen Sie dann die Bilddaten.

Wenn die aktuelle Übertragungssequenz abgebrochen wird, gibt die GetNextStream-MethodeS_FALSE zurück.