名称

device_get_softc — ドライバのプライベートなインスタンス変数へのアクセス

書式

#include < sys/param.h>
#include < sys/bus.h>

void *
device_get_softc( device_t dev);

解説

dev のドライバ特有な状態を返します。 softc は、デバイスがアタッチされるとき、自動的に割り付けられ、 0 クリアされます。また、softc は、デバイスがプローブされるとき、初期化され姿を現しますが、 DEVICE_PROBE(9) に説明されているような警告に制約されます。割り付けのサイズは、ドライバを定義するために使用されるデバイスの driver_t 情報によって決定されます。 softc は、通常、このデバイスのインスタンスの状態をカプセル化します。

ドライバの作者は、作者独自の softc 管理メカニズムを使用しないことを勧めます。ドライバの作者は、この関数より前のツリーのドライバで見つかるようなメカニズムをコピーするべきではありません。

戻り値

ドライバに特有なインスタンス変数へのポインタが返されます。

関連項目

device(9), DEVICE_PROBE(9), device_set_softc(9), driver(9)

作者

このマニュアルページは、 Doug Rabson によって書かれました。