> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man9/module_pnp_info.9.md).

# MODULE\_PNP\_INFO.9

`MODULE_PNP_INFO` — 注册用于设备匹配的即插即用信息

## 名称

`MODULE_PNP_INFO`

## 概要

```c
#include <sys/module.h>

MODULE_PNP_INFO(const char *descriptor_string, bus, module, void *table,
    size_t num_entries)
```

## 描述

`MODULE_PNP_INFO` 宏注册一个包含设备识别数据的 `table`，供 [devmatch(8)](/man/man8/devmatch.8.md) 使用。由于它基于模块标记宏构建，因此必须放在 [DRIVER\_MODULE(9)](/man/man9/driver_module.9.md) 行之后。

该宏接受一个 `descriptor_string` 来描述表项的内存布局。该字符串是由分号分隔的一系列成员组成的。成员由类型和名称标识。在描述符字符串中，通过将类型与冒号连接，后跟名称来编码它们。（特殊类型 `W32` 表示两个成员。第一个名称的编码方式与任何其他类型相同。第二个名称通过在第一个名称后追加正斜杠和第二个名称来编码。）

类型为以下之一：

**“`U8`”** `uint8_t` 元素。

**“`V8`”** 与 `U8` 相同，但哨兵值 0xFF 匹配任意值。

**“`G16`”** `uint16_t` 元素；大于或等于该值的任何值都匹配。

**“`L16`”** `uint16_t` 元素；小于或等于该值的任何值都匹配。

**“`M16`”** `uint16_t` 元素；用于指示以下哪些字段要使用的掩码。

**“`U16`”** `uint16_t` 元素。

**“`V16`”** 与 `U16` 相同，但哨兵值 0xFFFF 匹配任意值。

**“`U32`”** `uint32_t` 元素。

**“`V32`”** 与 `U32` 相同，但哨兵值 0xFFFFFFFF 匹配任意值。

**“`W32`”** 两个 `uint16_t` 值；第一个命名的成员在最低有效字中，第二个命名的成员在最高有效字中。

**“`Z`”** 指向需精确匹配的字符串的指针。

**“`D`”** 指向设备的人类可读描述的指针。

**“`P`”** 应被忽略的指针。

**“`E`”** EISA PNP 标识符。

**“`T`”** 对整个表都成立的 PNP 信息。驱动程序代码在使用此表匹配设备之前会实用地检查这些条件。此项必须放在列表的最后。

伪名称“#”保留给应被忽略的字段。任何与父设备的 pnpinfo 输出不匹配的成员都必须被忽略。

`bus` 参数是一个不带引号的词，命名驱动的父总线。例如“pci”。

`module` 参数也是一个不带引号的词。它对驱动必须唯一。通常使用驱动名称。

`table` 参数指向设备匹配数据，其条目与 `descriptor_string` 匹配。

`num_entries` 参数是表中的条目数，即 `nitems(table)`。注意只应包含有效的条目。如果表末尾包含尾随的零或无效值，则不应将它们包含在 `num_entries` 中。

## 实例

```c
#include <sys/param.h>
#include <sys/module.h>
static struct my_pciids {
	uint32_t devid;
	const char *desc;
} my_ids[] = {
	{ 0x12345678, "Foo bar" },
	{ 0x9abcdef0, "Baz fizz" },
};
MODULE_PNP_INFO("W32:vendor/device;D:#", pci, my_driver, my_ids,
    nitems(my_ids));
```

```c
#include <sys/param.h>
#include <sys/module.h>
static struct my_pciids {
	uint16_t device;
	const char *desc;
} my_ids[] = {
	{ 0x9abc, "Foo bar" },
	{ 0xdef0, "Baz fizz" },
};
MODULE_PNP_INFO("U16:device;D:#;T:vendor=0x1234", pci, my_driver,
    my_ids, nitems(my_ids));
```

**实例 1：为厂商/设备对使用 W32** 以下示例展示了当厂商/设备值组合为单个 `uint32_t` 值时 `W32` 类型的用法：

**实例 2：为公共厂商值使用 T** 以下示例展示了当表中所有条目具有相同厂商值时 `T` 类型的用法：

## 缺陷

由于 `linker.hints` 文件格式的限制，`MODULE_PNP_INFO` 宏必须放在 `DRIVER_MODULE` 调用之后。

## 参见

[devmatch(8)](/man/man8/devmatch.8.md), [DRIVER\_MODULE(9)](/man/man9/driver_module.9.md), [module(9)](/man/man9/module.9.md)

## 历史

`MODULE_PNP_INFO` 宏首次出现于 FreeBSD 11.0。

## 作者

PNP 框架和 [devmatch(8)](/man/man8/devmatch.8.md) 实用程序由 Warner Losh <imp@FreeBSD.org> 编写。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man9/module_pnp_info.9.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.