Win32 API 日本語リファレンス
ホーム › Networking.WindowsWebServices › WS_CREATE_DECODER_CALLBACK

WS_CREATE_DECODER_CALLBACK

コールバック

シグネチャ

HRESULT WS_CREATE_DECODER_CALLBACK(
    void* createContext,
    WS_READ_CALLBACK readCallback,
    void* readContext,
    void** decoderContext,
    WS_ERROR* error
);

パラメーター

フィールド型説明
createContextvoid*チャネルの作成時に使用した WS_CHANNEL_DECODER で指定された createContext です。
readCallbackWS_READ_CALLBACKメッセージデータの読み取りに使用する関数です。このコールバックは、WS_DECODER_START_CALLBACK、 WS_DECODER_DECODE_CALLBACK、WS_DECODER_END_CALLBACK の各コールバックに 応答する場合にのみ使用してください。
readContextvoid*

指定された WS_READ_CALLBACK に渡す読み取りコンテキストです。

- **decoderContext

デコーダーインスタンスを返します。この値は、 すべてのデコーダーコールバックに渡されます。

decoderContextvoid**デコーダーインスタンスを返します。この値は、 すべてのデコーダーコールバックに渡されます。
errorWS_ERROR*関数が失敗した場合に、追加のエラー情報を格納する場所を指定します。

公式ドキュメント

デコーダーインスタンスの作成を処理します。

戻り値

このコールバック関数は、次のいずれかの値を返すことができます。

戻り値 説明
E_OUTOFMEMORY
 メモリが不足しました。
E_INVALIDARG
 1 つ以上の引数が無効です。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

解説(Remarks)

チャネルは、必要に応じてデコーダーインスタンスを作成します。各デコーダー インスタンスはシングルスレッドで呼び出されます。ただし、チャネルはメッセージの 処理に複数のデコーダーインスタンスを使用する場合があるため、1 つのデコーダー インスタンスがチャネルのすべてのメッセージを参照するとは限りません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)