目次 - SDL_net 3.0 - NET_DestroyDatagram

NET_DestroyDatagram

以前に受信したデータグラムパケットを破棄する

ヘッダ

SDL3_net/SDL_net.h

構文

void NET_DestroyDatagram(NET_Datagram *dgram);

引数

*dgram破棄するデータグラムパケット

詳細

NET_ReceiveDatagramで受信したパケットは, 不要になったときこの関数に渡す必要がある. この関数はパケットが使用する資源を解放し, NET_Addressの参照を外す.

送信側のアドレスを長時間保存したい場合は, そのアドレスにNET_RefAddress()を呼びポインタを保持すると安全である. その場合はアドレスが不要になったときNET_UnrefAddress()を呼ぶ必要がある.

この関数を呼んだ後は, データグラムポインタは無効になるのでアプリケーションで再び使用してはならない.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL_net 3.0.0以降

SDL Wikiへのリンク

SDL3_net/NET_DestroyDatagram