pci_plist_lookup() インタフェース

ドライバでpci_plist_lookup(9F) インタフェースを使用すると、サポートされているさまざまなデータ型の名前-値ペアを検索できます。この関数は、名前とインタフェース名で示された型に一致する nvpair (名前-値ペア) を検索します。見つかった場合、nelem と val が変更され、値の要素数とデータの開始アドレスがそれぞれ格納されます。

pci_plist_lookup() インタフェースでは次のデータ型がサポートされています。

• int pci_plist_lookup_int8(pci_plist_t plist , const char *name,int8_t * val)

• int pci_plist_lookup_uint8(pci_plist_t plist , const char *name,uint8_t * val)

• int pci_plist_lookup_int16(pci_plist_t plist , const char *name,int16_t * val)

• int pci_plist_lookup_uint16(pci_plist_t plist , const char *name, uint16_t * val)

• int pci_plist_lookup_int32(pci_plist_t plist , const char *name,int32_t * val)

• int pci_plist_lookup_uint32(pci_plist_t plist , const char *name, uint32_t * val)

• int pci_plist_lookup_int64(pci_plist_t plist , const char *name,int64_t * val)

• int pci_plist_lookup_uint64(pci_plist_t plist , const char *name, uint64_t * val)

• int pci_plist_lookup_string(pci_plist_t plist , const char *name, char ** val)

• int pci_plist_lookup_plist(pci_plist_t plist , const char *name, pci_plist_t ** val)

• int pci_plist_lookup_int8_array(pci_plist_t plist, const char *name,int8_t * val, uint_t *nelem)

• int pci_plist_lookup_uint8_array(pci_plist_t plist, const char *name, int8_t * val, uint_t *nelem)

• int pci_plist_lookup_int16_array(pci_plist_t plist, const char *name,int16_t * val, uint_t *nelem)

• int pci_plist_lookup_uint16_array(pci_plist_t plist, const char *name, uint16_t *val, uint_t *nelem)

• int pci_plist_lookup_int32_array(pci_plist_t plist, const char *name,int32_t * val, uint_t *nelem)

• int pci_plist_lookup_uint32_array(pci_plist_t plist, const char *name,uint32_t *val, uint_t *nelem)

• int pci_plist_lookup_int64_array(pci_plist_t plist, const char *name, int64_t *val, uint_t *nelem)

• int pci_plist_lookup_uint64_array(pci_plist_t plist,const char *name,uint64_t * val, uint_t *nelem)

• int pci_plist_lookup_string_array(pci_plist_t plist, const char *name,char ** val, uint_t *nelem)

ここでは:

plist

処理対象となる pci_plist_t 構造体へのポインタ。

name

検索する名前-値ペアの名前。

nelem

値の要素数を格納するアドレス。

val

データの開始アドレス。

pci_plist_lookup() 関数は、成功時は 0 を返し、失敗時はエラー値を返します。次のエラー値がサポートされています。

DDI_EINVAL

無効な引数

ENOENT

一致する名前-値ペアが見つかりません

ENOTSUP

エンコードまたはデコードの方式がサポートされていません