Método IWiaMiniDrvTransferCallback::GetNextStream (wiamindr_lh.h)

Artigo
03/01/2024

Chamado pelo mini driver WIA para obter um fluxo para a transferência de dados atual (download ou upload).

Sintaxe

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

Parâmetros

[in] lFlags

Representa bits de sinalizador. Esse parâmetro não é utilizado e deve ser sempre definido como zero (0) pelo chamador.

[in] bstrItemName

O nome do item que executará a transferência de dados.

Para obter mais informações, consulte WIA_IPA_ITEM_NAME.

[in] bstrFullItemName

O nome completo do item que executará a transferência de dados.

Para obter mais informações, consulte WIA_IPA_FULL_ITEM_NAME.

[out] ppIStream

Um ponteiro para um objeto IStream .

Retornar valor

Esse método retorna S_OK quando a chamada é bem-sucedida. Caso contrário, retornará um código de erro HRESULT apropriado.

Comentários

Quando o cliente solicita ignorar a transferência de dados, o método GetNextStream retorna WIA_STATUS_SKIP_ITEM. O mini driver WIA deve ignorar a transferência de imagem atual e continuar com a próxima transferência de imagem, se houver. Por exemplo, para uma transferência de download, conclua a verificação da imagem atual e descarte os dados da imagem.

Quando a sequência de transferência atual é cancelada, o método GetNextStream retorna S_FALSE.