次の方法で共有

増分シリアル化

増分スタイルのシリアル化を使用する場合は、バッファーを操作する 3 つのルーチンを指定します。 これらのルーチンは、Alloc、Read、Write です。 Alloc ルーチンは、必要なサイズのバッファーを割り当てます。 書き込みルーチンはバッファーにデータを書き込み、読み取りルーチンはマーシャリングされたデータを含むバッファーを取得します。 1 回のシリアル化呼び出しで、これらのルーチンを複数呼び出すことができます。

シリアル化の増分スタイルでは、次のルーチンを使用します。

指定する必要がある Alloc、Read、Write 関数のプロトタイプを次に示します。

void __RPC_USER Alloc (
   void *State,          /* application-defined pointer */
   char **pBuffer,       /* returns pointer to allocated buffer */
   unsigned int *pSize); /* inputs requested bytes; outputs 
                         /* pBuffer size */

void __RPC_USER Write (
   void *State,          /* application-defined pointer */
   char *Buffer,         /* buffer with serialized data */
   unsigned int Size);   /* number of bytes to write from Buffer */

void __RPC_USER Read (
   void *State,          /* application-defined pointer */
   char **pBuffer,       /* returned pointer to buffer with data */
   unsigned int *pSize); /* number of bytes to read into pBuffer */

3 つの関数すべてにパラメーターを入力する State は、エンコード サービス ハンドルに関連付けられたアプリケーション定義ポインターです。 アプリケーションはこのポインターを使用して、ファイル ハンドルやストリーム ポインターなどのアプリケーション固有の情報を含む構造体にアクセスできます。 スタブは、Alloc、Read、Write 関数に渡す以外に State ポインターを変更しないことに注意してください。 エンコード中に Alloc が呼び出され、データがシリアル化されるバッファーが取得されます。 次に、Write が呼び出され、シリアル化されたデータが格納されるタイミングと場所をアプリケーションが制御できるようになります。 デコード中に、Read が呼び出され、アプリケーションによって格納されたシリアル化されたデータの要求されたバイト数が返されます。

増分スタイルの重要な機能は、ハンドルが状態ポインターを保持することです。 このポインターは状態を維持し、Alloc、Write、または Read 関数にポインターを渡す場合を除き、RPC 関数によって操作されることはありません。 また、このハンドルは内部状態を維持するため、配置に必要に応じてパディングを追加することで、複数の型インスタンスをエンコードして同じバッファーにデコードできます。 MesIncrementalHandleReset 関数は、バッファーの先頭からの読み取りまたは書き込みを有効にするために、ハンドルを初期状態にリセットします。

Alloc 関数と Write 関数は、アプリケーション定義ポインターと共に、MesEncodeIncrementalHandleCreate 関数の呼び出しによってエンコード サービス ハンドルに関連付けられます。 MesEncodeIncrementalHandleCreate ハンドルに必要なメモリを割り当ててから初期化します。

アプリケーションは、MesDecodeIncrementalHandleCreate を呼び出してデコード ハンドルを作成したり、MesIncrementalHandleResetをしてハンドルを再初期化したり、MesHandleFreeをしてハンドルのメモリを解放することができます。 Read 関数は、アプリケーション定義パラメーターと共に、MesDecodeIncrementalHandleCreate ルーチンの呼び出しによってデコード ハンドルに関連付けられます。 この関数はハンドルを作成し、初期化します。

MesIncrementalHandleReset の UserState、Alloc、Write、および Read の各パラメーターは、NULL して変更がないことを示すことができます。

 

 

  • Last updated on