19.6.106. PinGroupFunction（引脚组功能配置描述符宏）

语法 :

Macro:

PinGroupFunction (Shared/Exclusive, FunctionNumber, ResourceSource, ResourceSourceIndex,
ResourceSourceLabel, ResourceUsage, DescriptorName, VendorData)

参数

  • Shared 是一个可选参数，可以是 Shared 或 Exclusive 之一。如果未指定，则假定为 Exclusive。会自动创建位字段名 _SHR 以引用资源描述符的这一部分。

  • FunctionNumber 是一个特定于提供者的整数，用于指示所描述的是哪个功能。会自动创建位字段名 _FUN 以引用资源描述符的这一部分。

  • ResourceSource 是一个字符串，用于唯一标识 GPIO 控制器，该控制器包含此描述符所引用的 PinGroup 资源。ResourceSource 可以是完全限定名、相对名称，或利用命名空间搜索规则的名称段。

  • ResourceSourceLabel 是一个非空字符串参数，它与由 ResourceSource 引用的 GPIO 控制器当前资源模板缓冲区中某个 PinGroup 资源的 ResourceLabel 匹配。

  • DescriptorName 是一个可选参数，用于指定一个整数常量的名称，该常量将在当前作用域中创建，并包含此资源描述符在当前资源模板缓冲区内的偏移量。可将预定义的描述符字段名附加到该名称后，以通过缓冲区字段运算符访问描述符中的各个字段。

  • ResourceSourceIndex 是一个可选参数，在此修订版本中假定为 0。

  • ResourceUsage 是一个可选参数，在此修订版本中假定为 ResourceConsumer。

  • VendorData 是一个可选参数，用于指定一个 RawDataBuffer，其中包含由 OS 驱动程序解码的厂商定义字节数据。会自动创建位字段名 _VEN 以引用资源描述符的这一部分。

说明

PinGroupFunction 宏求值为一个缓冲区，其中包含一个引脚功能资源描述符。引脚功能资源描述符的格式可参见Pin Function Descriptor。此宏设计用于 ResourceTemplate（资源到缓冲区转换宏）内部。