LPFN_RIODEREGISTERBUFFER コールバック関数 (mswsock.h)
RIODeregisterBuffer 関数は、Winsock 登録済み I/O 拡張機能で使用される登録済みバッファーを登録解除します。
構文
LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;
void LpfnRioderegisterbuffer(
RIO_BUFFERID BufferId
)
{...}
パラメーター
BufferId
登録済みバッファーを識別する記述子。
戻り値
なし
解説
RIODeregisterBuffer 関数は、登録済みバッファーを登録解除します。 バッファーが登録解除されると、アプリケーションは BufferId パラメーターで渡されたバッファー識別子を使用して行われることを示します。 このバッファー識別子を使用しようとする他の関数に対する後続の呼び出しは失敗します。
まだ使用中のバッファーが登録解除されると、結果は未定義になります。 これは重大なエラーと見なされます。 RIODequeueCompletion 関数によって返される RIORESULT 構造体では、状態は通常の状態と変わりません。 アプリケーション開発者は、アプリケーション検証ツールを使用してこのエラー状態を検出できます。
BufferId パラメーターに無効なバッファー識別子が渡された場合、これは RIODeregisterBuffer 関数によって無視されます。
注意
RIODeregisterBuffer 関数への関数ポインターは、実行時に、SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTERオペコードを指定して WSAIoctl 関数を呼び出すことによって取得する必要があります。 WSAIoctl 関数に渡される入力バッファーには、Winsock 登録済み I/O 拡張関数を識別する値を持つグローバル一意識別子 (GUID) WSAID_MULTIPLE_RIOが含まれている必要があります。 成功すると、 WSAIoctl 関数によって返される出力には、Winsock に登録されている I/O 拡張関数へのポインターを含む RIO_EXTENSION_FUNCTION_TABLE 構造体へのポインターが含まれます。 SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL は、Ws2def.h ヘッダー ファイルで定義されます。 WSAID_MULTIPLE_RIO GUID は、Mswsock.h ヘッダー ファイルで定義されています。
Windows Phone 8: この関数は、Windows Phone 8 以降の Windows Phone ストア アプリでサポートされています。
Windows 8.1とWindows Server 2012 R2: この関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストア アプリでサポートされています。
要件
要件 | 値 |
---|---|
Header | mswsock.h |