IBidiRequest::GetOutputData メソッド (bidispl.h)

  • [アーティクル]

GetOutputData メソッドは、プリンターから返される指定された出力データを取得します。

構文

HRESULT GetOutputData(
  [in]  const DWORD dwIndex,
  [out] LPWSTR      *ppszSchema,
  [out] DWORD       *pdwType,
  [out] BYTE        **ppData,
  [out] ULONG       *uSize
);

パラメーター

[in] dwIndex

要求された出力データの 0 から始まるインデックス。 詳細については、「解説」を参照してください。

[out] ppszSchema

スキーマ文字列を受け取る NULL で終わる文字列へのポインター。 このポインターを解放するには、呼び出し元が CoTaskMemFree 関数を呼び出す必要があります。

[out] pdwType

出力データの型を受け取る変数へのポインター。 このパラメーターには、次の値のいずれかを指定できます。

値 説明
BIDI_NULL データがありません。
BIDI_INT 整数データ。
BIDI_FLOAT 浮動小数点数。
BIDI_BOOL TRUE または FALSE
BIDI_STRING Unicode 文字列。
BIDI_TEXT ローカライズできない Unicode 文字列。
BIDI_ENUM Unicode 文字列の形式でデータを列挙します。
BIDI_BLOB バイナリ データ。

[out] ppData

出力データを含むバイト配列へのポインターを受け取る変数へのポインター。 バッファーは、出力データを格納するために COM インターフェイスによって割り当てられます。 呼び出し元は、 CoTaskMemFree を呼び出してバッファーを解放する役割を担います。

[out] uSize

**ppData で指定されたバイト配列のサイズを受け取る変数へのポインター。

戻り値

メソッドは、次のいずれかの値を返します。 COM エラー コードの詳細については、「 COM エラー コード」を参照してください。

リターン コード 説明
S_OK 操作は正常に実行されました。
E_HANDLE インターフェイス ハンドルが無効です。
E_POINTER ポインター変数パラメーターの少なくとも 1 つが有効なメモリ位置を参照しませんでした。
上記のどれでもない HRESULT には、最後のエラーに対応するエラー コードが含まれています。

注釈

1 つの bidi 要求で複数の結果を得ることができます。 アプリケーションは GetEnumCount を 呼び出して、bidi 要求から結果の数を取得します。

アプリケーションが同じインデックスを持つ GetOutputData を 2 回呼び出す場合、インターフェイスは 2 つの異なるバッファーを割り当てるので、アプリケーションは両方のバッファーを解放する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
対象プラットフォーム デスクトップ
Header bidispl.h
[DLL] Bidispl.dll

こちらもご覧ください

双方向通信インターフェイス

双方向通信スキーマ

GetEnumCount

IBidiRequest