IWiaMiniDrvTransferCallback::GetNextStream メソッド (wiamindr_lh.h)

[アーティクル]
03/05/2024

現在のデータ転送 (ダウンロードまたはアップロード) のストリームを取得するために、WIA ミニドライバーによって呼び出されます。

構文

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

パラメーター

[in] lFlags

フラグビットを表します。このパラメーターは使用されず、呼び出し元は常にゼロ (0) に設定する必要があります。

[in] bstrItemName

データ転送を実行するアイテムの名前。

詳細については、「 WIA_IPA_ITEM_NAME」を参照してください。

[in] bstrFullItemName

データ転送を実行するアイテムの完全な名前。

詳細については、「 WIA_IPA_FULL_ITEM_NAME」を参照してください。

[out] ppIStream

IStream オブジェクトへのポインター。

戻り値

このメソッドは、呼び出しが成功したときに S_OK を返します。それ以外の場合は、適切な HRESULT エラーコードが返されます。

注釈

クライアントがデータ転送のスキップを要求すると、 GetNextStream メソッドは WIA_STATUS_SKIP_ITEMを返します。 WIA ミニドライバーは、現在のイメージ転送をスキップし、次のイメージ転送 (存在する場合) を続行する必要があります。たとえば、ダウンロード転送の場合は、現在のイメージのスキャンを完了し、画像データを破棄します。

現在の転送シーケンスが取り消されると、 GetNextStream メソッドは S_FALSEを返します。