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

WS_CREATE_ENCODER_CALLBACK

コールバック

シグネチャ

HRESULT WS_CREATE_ENCODER_CALLBACK(
    void* createContext,
    WS_WRITE_CALLBACK writeCallback,
    void* writeContext,
    void** encoderContext,
    WS_ERROR* error
);

パラメーター

フィールド型説明
createContextvoid*チャネルの作成時に使用された WS_CHANNEL_ENCODER で指定された createContext です。
writeCallbackWS_WRITE_CALLBACKメッセージデータの書き込みに使用する関数です。このコールバックは、WS_ENCODER_START_CALLBACK、 WS_ENCODER_ENCODE_CALLBACK、WS_ENCODER_END_CALLBACK の各コールバックへの応答としてのみ使用してください。
writeContextvoid*

指定された WS_WRITE_CALLBACK に渡す書き込みコンテキストです。

- **encoderContext

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

encoderContextvoid**エンコーダーインスタンスを返します。この値は、 すべてのエンコーダーコールバックに渡されます。
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)