Undocumented #CONTAINING_RECORD macro

WINDBG
1

Dear WinDbg team,

I found that #CONTAINING_RECORD macro is present among script samples but
did not find any other documentation for it. Could it be added to WinDbg
documentation? Is WinDbg supports other useful macro like #FIELD_OFFSET?

Best regards,
Oleksiy Shatylo

2

Look in the DDK, this is documented there.

–
Don Burn (MVP, Windows DDK)
Windows 2k/XP/2k3 Filesystem and Driver Consulting
http://www.windrvr.com
Remove StopSpam from the email to reply

“Oleksiy Shatylo” wrote in message news:xxxxx@windbg…
> Dear WinDbg team,
>
> I found that #CONTAINING_RECORD macro is present among script samples but
> did not find any other documentation for it. Could it be added to WinDbg
> documentation? Is WinDbg supports other useful macro like #FIELD_OFFSET?
>
> Best regards,
> Oleksiy Shatylo
>
>

3

Hello Don,

Look in the DDK, this is documented there.
I am sorry but DDK documentation for CONTAINING_RECORD is about C
implementation of macro with same name. How WinDbg user can find out that
same macro is possible to use in WinDbg scripts? This is possible to detect
now only from one example in WinDbg help. My notice was exactly about this.

Best regards,
Oleksiy Shatylo

-----Original Message-----
From: xxxxx@lists.osr.com
[mailto:xxxxx@lists.osr.com] On Behalf Of Don Burn
Sent: Tuesday, August 01, 2006 2:11 PM
To: Kernel Debugging Interest List
Subject: Re:[windbg] Undocumented #CONTAINING_RECORD macro

Look in the DDK, this is documented there.

–
Don Burn (MVP, Windows DDK)
Windows 2k/XP/2k3 Filesystem and Driver Consulting
http://www.windrvr.com Remove StopSpam from the email to reply

“Oleksiy Shatylo” wrote in message
> news:xxxxx@windbg…
> > Dear WinDbg team,
> >
> > I found that #CONTAINING_RECORD macro is present among
> script samples but
> > did not find any other documentation for it. Could it be
> added to WinDbg
> > documentation? Is WinDbg supports other useful macro like
> #FIELD_OFFSET?
> >
> > Best regards,
> > Oleksiy Shatylo
> >
> >
>
>
>
> —
> You are currently subscribed to windbg as: xxxxx@nero.com
> To unsubscribe send a blank email to xxxxx@lists.osr.com
>

4

windbg supports the following CPP-like macros.

#CONTAINING_RECORD(Ptr, Type, Field)
#FIELD_OFFSET(Type, Field)
#RTL_FIELD_SIZE(Type, Field)
#RTL_SIZEOF_THROUGH_FIELD(Type, Field)
#RTL_CONTAINS_FIELD(Type, Bytes, Field)
#RTL_NUMBER_OF(Array)

I’ve opened a bug against the doc writers to make sure these get doc’ed.

-----Original Message-----
From: xxxxx@lists.osr.com
[mailto:xxxxx@lists.osr.com] On Behalf Of Oleksiy Shatylo
Sent: Tuesday, August 01, 2006 5:38 AM
To: Kernel Debugging Interest List
Subject: RE: [windbg] Undocumented #CONTAINING_RECORD macro

Hello Don,

Look in the DDK, this is documented there.
I am sorry but DDK documentation for CONTAINING_RECORD is about C
implementation of macro with same name. How WinDbg user can find out
that same macro is possible to use in WinDbg scripts? This is possible
to detect now only from one example in WinDbg help. My notice was
exactly about this.

Best regards,
Oleksiy Shatylo

-----Original Message-----
From: xxxxx@lists.osr.com
[mailto:xxxxx@lists.osr.com] On Behalf Of Don Burn
Sent: Tuesday, August 01, 2006 2:11 PM
To: Kernel Debugging Interest List
Subject: Re:[windbg] Undocumented #CONTAINING_RECORD macro

Look in the DDK, this is documented there.

–
Don Burn (MVP, Windows DDK)
Windows 2k/XP/2k3 Filesystem and Driver Consulting
http://www.windrvr.com Remove StopSpam from the email to reply

“Oleksiy Shatylo” wrote in message
> news:xxxxx@windbg…
> > Dear WinDbg team,
> >
> > I found that #CONTAINING_RECORD macro is present among
> script samples but
> > did not find any other documentation for it. Could it be
> added to WinDbg
> > documentation? Is WinDbg supports other useful macro like
> #FIELD_OFFSET?
> >
> > Best regards,
> > Oleksiy Shatylo
> >
> >
>
>
>
> —
> You are currently subscribed to windbg as: xxxxx@nero.com To
> unsubscribe send a blank email to xxxxx@lists.osr.com
>

—
You are currently subscribed to windbg as: xxxxx@winse.microsoft.com To
unsubscribe send a blank email to xxxxx@lists.osr.com

5

Hello Drew,

Thanks a lot for submitting this documentation bug.

Best regards,
Oleksiy Shatylo

-----Original Message-----
From: xxxxx@lists.osr.com
[mailto:xxxxx@lists.osr.com] On Behalf Of Drew Bliss
Sent: Tuesday, August 01, 2006 7:26 PM
To: Kernel Debugging Interest List
Subject: RE: [windbg] Undocumented #CONTAINING_RECORD macro

windbg supports the following CPP-like macros.

#CONTAINING_RECORD(Ptr, Type, Field)
#FIELD_OFFSET(Type, Field)
#RTL_FIELD_SIZE(Type, Field)
#RTL_SIZEOF_THROUGH_FIELD(Type, Field)
#RTL_CONTAINS_FIELD(Type, Bytes, Field)
#RTL_NUMBER_OF(Array)

I’ve opened a bug against the doc writers to make sure these
get doc’ed.

-----Original Message-----
From: xxxxx@lists.osr.com
[mailto:xxxxx@lists.osr.com] On Behalf Of
Oleksiy Shatylo
Sent: Tuesday, August 01, 2006 5:38 AM
To: Kernel Debugging Interest List
Subject: RE: [windbg] Undocumented #CONTAINING_RECORD macro

Hello Don,

> Look in the DDK, this is documented there.
I am sorry but DDK documentation for CONTAINING_RECORD is
about C implementation of macro with same name. How WinDbg
user can find out that same macro is possible to use in
WinDbg scripts? This is possible to detect now only from one
example in WinDbg help. My notice was exactly about this.

Best regards,
Oleksiy Shatylo

> -----Original Message-----
> From: xxxxx@lists.osr.com
> [mailto:xxxxx@lists.osr.com] On Behalf Of Don Burn
> Sent: Tuesday, August 01, 2006 2:11 PM
> To: Kernel Debugging Interest List
> Subject: Re:[windbg] Undocumented #CONTAINING_RECORD macro
>
> Look in the DDK, this is documented there.
>
>
> –
> Don Burn (MVP, Windows DDK)
> Windows 2k/XP/2k3 Filesystem and Driver Consulting
> http://www.windrvr.com Remove StopSpam from the email to reply
>
>
>
> “Oleksiy Shatylo” wrote in message
> > news:xxxxx@windbg…
> > > Dear WinDbg team,
> > >
> > > I found that #CONTAINING_RECORD macro is present among
> > script samples but
> > > did not find any other documentation for it. Could it be
> > added to WinDbg
> > > documentation? Is WinDbg supports other useful macro like
> > #FIELD_OFFSET?
> > >
> > > Best regards,
> > > Oleksiy Shatylo
> > >
> > >
> >
> >
> >
> > —
> > You are currently subscribed to windbg as: xxxxx@nero.com To
> > unsubscribe send a blank email to xxxxx@lists.osr.com
> >
>
>
> —
> You are currently subscribed to windbg as:
> xxxxx@winse.microsoft.com To unsubscribe send a blank email
> to xxxxx@lists.osr.com
>
>
> —
> You are currently subscribed to windbg as: unknown lmsubst
> tag argument: ‘’
> To unsubscribe send a blank email to xxxxx@lists.osr.com
>