vQueueAddToRegistry

[Queue Management]

queue.h

void vQueueAddToRegistry( xQueueHandle xQueue, signed portCHAR *pcQueueName, );

待ち行列に名前を割り当て、レジストリに待ち行列を加える。

パラメータ:
xQueue   レジストリに加える待ち行列のハンドル。

pcQueueName   待ち行列に割り当てられる名前。 これはデバッグの容易化のために使われるテキストストリングです。

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

カーネル対応デバッガを使っていないなら、待ち行列レジストリは目的を失います。
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" ); 
}