vQueueUnregisterQueue

[Queue Management]

queue.h

void vQueueUnregisterQueue( xQueueHandle xQueue, );

待ち行列を待ち行列レジストリから取り除きます。

パラメータ：
xQueue 　　レジストリから取り除かれる待ち行列のハンドル。

待ち行列レジストリはカーネル対応デバッギングと結び付けられる２つの目的を持っています：
１．それは原文の名前がデバッギング GUI の中で容易な待ち行列同定のために待ち行列と結び付けられることを可能にします。
２．それはそれぞれの登録された待ち行列とセマフォの位置を定めるためにデバッガによって必要とされるインフォメーションを含んでいます。

カーネル対応デバッガを使っていないなら、待ち行列レジストリは目的を失います。
configQUEUE_REGISTRY_SIZE が登録されることができる待ち行列とセマフォの最大値を定義します。 カーネル対応デバッガを使う時、望む待ち行列とセマフォのみを登録されている必要があります。

例：

void vAFunction( void ) 
{ 
    xQueueHandle xQueue; 
    /* Create a queue big enough to hold 10 chars. */  
    xQueue = xQueueCreate( 10, sizeof( portCHAR ) ); 
    /* We want this queue to be viewable in a kernel aware debugger, so register it. */  
    vQueueAddToRegistry( xQueue, "AMeaningfulName" ); 
    /* The queue gets used here. */  
    /* At some later time, the queue is going to be deleted, first remove it from the registry. */
    vQueueUnregisterQueue( xQueue ); vQueueDelete( xQueue ); 
}