[原创]CONTAINING_RECORD IN EFI

peterhu

CONTAINING_RECORD IN EFI

8 w1 S" n% y0 f9 p$ v: Z
! z7 M" U$ q, ~( AEFI BIOS几乎全部用C完成，它几乎将C语言的各种技巧发挥到了极致。C的精髓泰半是指针，另外宏也是非常值得称道的。程序员对于宏的评价可谓褒贬不一，有人说它是万恶之源，有人则赞其为一把利刃。我个人觉得运用之妙，存乎一心，宏不是万能的，但是有一些场合使用宏确实可以大大的提高程序的可读性，有些跨平台的特性离开了宏还真是不行。_CR是EFI之中经常会被用的宏，我们来看看它的庐山真面目吧：

6 t" u; J% }+ n, L7 c

//

3 @) k' S: I% ^

//
1 b2 D9 p" Q6 B: M+ [, i! oCONTAINING_RECORD - returns a pointer to the structure

//
from one of it's elements.

, Z$ v" w& r, x3 r! \0 v7 |+ ]- \; J, k

//

#define _CR(Record, TYPE, Field)
((TYPE *) ((CHAR8 *) (Record) - (CHAR8 *) &(((TYPE *) 0)->Field)))
4 n# W; m/ I; y- Z  g$ d8 z这个宏的作用是根据一个结构体成员变量的的地址获得该结构体基地址。举例如下：
struct _Test
{
2 K. i, p; e( ~) ECHAR8 t0;
1 w! x. u2 V2 Z0 W8 I# o6 G
# S" o' Z+ t* d7 K+ r! p2 }) mUINT16 t1;
, A1 R" J/ W0 `" U
* F$ Y3 ^% I$ FUINT8   t2;

% W' E. A2 J( }9 gUINT32  t3;
" `6 M% \2 s" Y6 c; M};
! j" @% U! v1 W0 w2 K0 r
. t8 m( F8 ]! m6 g# C& B( C2 r我们在某一个地方获得了t2的地址t2Ptr，这时如果要得到t2所在结构体的基地址就可以这样做：struct _Test* bPtr = _CR(t2Ptr,struct _Test,t2);预处理展开之后就是这副样子 struct _Test* bPtr = ((struct _Test*)((CHAR8*)(t2Ptr)-(CHAR8*)&((struct _Test *)0)->t2)，其实我觉得关键的部分在这句“(TYPE *) 0)->Field”，它其实就是获得该成员在结构体中的偏移位置（offset），该成员变量的地址减去它在结构体中的偏移也就获得了基地址了。
/ K' o0 x* e, q7 ^! r. f7 b6 w
% F! s3 A! d$ e
3 ^! G& k' l2 U& b一图胜千言，如上图所示，假设t2的地址是0x1005,那么bPtr应该是多少呢？我们只要用t2-t2的offset（0x03）即可，也就是0x1002。是不是很简单?

大概是英雄所见略同吧，这种形式的宏在Linux kernel 和 Windows Kernel中也都有存在，只不过名字叫的不一样罢了。先看看Linux下长的什么样子吧：
* j& U- B" \  g7 ]

/**

! Y# ]. `, E% ?* u0 c9 Y

' _. @1 u8 o6 o- d$ R* container_of - cast a member of a structure out to the containing structure

*

7 V* ]+ N, D2 x8 x* @ptr:
the pointer to the member.

+ h3 n  ~2 T9 [5 e$ h; C6 u) \6 C7 g

* F( ]0 Z: M+ G* @type:
9 S, p6 M+ L/ U+ lthe type of the container struct this is embedded in.

7 w& ]: k  e1 L1 }% w

* @member:
& P7 T( H8 N6 `+ w2 g: K2 y% @the name of the member within the struct.

*

4 G! m$ Y: M1 ]3 H*/

1 k* E, ]$ B+ U9 ^- s#define
1 l7 P! M0 v  `1 T- c9 U9 ^container_of(ptr, type, member) ({
( ]/ P  I* }" ]; e" M\
4 o! ]. D. ?5 z' H
const typeof( ((type *)0)->member ) *__mptr = (ptr);
\

(type *)( (char *)__mptr - offsetof(type,member) );})
# r1 |+ L* B+ X6 s; W8 _9 H$ I
#define offsetof(TYPE, MEMBER) ((size_t) &((TYPE *)0)->MEMBER)

再来看看它在Windows Kernel中的小模样J:
! W- n! X: i0 T6 E0 Y3 ]0 P3 P#define
8 @1 s: O# C8 n$ J, v) CCONTAININT_RECORD(address, type, field) \
  O0 F1 R9 ?2 r' ]8 S- T6 o             ((type*)((PCHAR)(address) - (PCHAR)(&((type*)0)->field)))
他们的作用都是一样的，是不是有点天下文章一大抄的感觉啊,呵呵…

  j% {6 m+ N4 Y3 H5 g# @" e

Peter
5 h  d* f# E. t2 D- U
2009-10-6

bellid

顺楼主者昌,逆楼主者亡.

adward

象这样的宏挺绕人的，但又经常会碰到。
# p! G6 D; j5 p  u% F( ^! @楼主将其重点突出，从而问题变得很直接很明了了。。顶一个哈

xxxxxxxx

崇拜中。。。。。。。