Metodo IWiaMiniDrvTransferCallback::GetNextStream (wiamindr_lh.h)

Articolo
03/05/2024

Chiamato dal mini-driver WIA per ottenere un flusso per il trasferimento dei dati corrente (download o caricamento).

Sintassi

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

Parametri

[in] lFlags

Rappresenta i bit del flag. Questo parametro non è usato e deve essere sempre impostato su zero (0) dal chiamante.

[in] bstrItemName

Nome dell'elemento che eseguirà il trasferimento dei dati.

Per altre informazioni, vedere WIA_IPA_ITEM_NAME.

[in] bstrFullItemName

Nome completo dell'elemento che eseguirà il trasferimento dei dati.

Per altre informazioni, vedere WIA_IPA_FULL_ITEM_NAME.

[out] ppIStream

Puntatore a un oggetto IStream .

Valore restituito

Questo metodo restituisce S_OK quando la chiamata ha esito positivo. In caso contrario, restituisce un codice di errore HRESULT appropriato.

Commenti

Quando il client richiede di ignorare il trasferimento dei dati, il metodo GetNextStream restituisce WIA_STATUS_SKIP_ITEM. Il mini-driver WIA deve ignorare il trasferimento dell'immagine corrente e continuare con il trasferimento dell'immagine successivo, se presente. Ad esempio, per un trasferimento di download, completare l'analisi dell'immagine corrente e quindi eliminare i dati dell'immagine.

Quando la sequenza di trasferimento corrente viene annullata, il metodo GetNextStream restituisce S_FALSE.