int NET_GetStreamSocketPendingWrites(NET_StreamSocket *sock);
| NET_StreamSocket * | sock | 問い合わせるストリームソケット |
NET_WriteToStreamSocket()は即座に全てのデータを送れなかったとき, 後で送るためにキューに入れる. アプリケーションはこの関数でまだキューの中にあるデータのバイト数を知ることができる.
ライブラリは残りバイト数を報告する前にキューのデータを送ろうとするが, そのためにブロックはしない.
接続に失敗すると(リモート側の切断や, 様々な種類のネットワーク障害の発生により), この関数は-1を戻して失敗を報告する. ストリームソケットが失敗を報告するのは回復不能な場合のみであるため, 一度ソケットが失敗すると使用することはできないとみなし, NET_DestroyStreamSocket()で破棄する必要がある.
同じソケットを複数のスレッドから同期を行わずに使用してはならない. しかし, 異なるスレッドから別々のソケットに同時にアクセスすることは問題ない.