MSDN docs mistake ?

NTDEV
1

Hi,
I am planning to use IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS in one of my
drivers and I noticed that the MSDN docs state that this IOCTL requires
Windows XP.
(http://msdn.microsoft.com/library/default.asp?url=/library/en-us/fileio/bas
e/ioctl_volume_get_volume_disk_extents.asp).

The weird thing is that I found another document that states that this IOCTL
is introduced in Windows 2K.
(http://www.microsoft.com/whdc/devtools/ifskit/ntupto2k.mspx).

I also found another document that states this IOCTL will work even on
Windows NT 4.0.
(http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnappcom/h
tml/win2000appcomp.asp).

So I’m confused. I tested this myself on Win2K and WinXP and as far as I can
tell this IOCTL works on both platforms. There is, however, the exception of
removable storage (the IOCTL is supported for removable storage only on
WinXP), but I can live with that.

So what I’m actually asking is - Is it safe to assume that the MSDN is wrong
and this IOCTL is supported for non-removable storage on both Win2K and
WinXP?

Thanks,
Shahar.

2

Thanks for the feedback, Shahar!

This is an SDK doc. The DDK description of this IOCTL doesn’t have this
restriction. I’ve notified the SDK doc manager.

If you ever find a doc problem, scroll to the bottom of the doc page and
click the link to provide feedback.

– In the SDK, use the “What did you think of this topic?” link.
– In the DDK, use the “Send feedback on this topic.” link.

Oh, and you can use these to send compliments and suggestions, too.

Thanks,
June

June Blender (MSFT)
DDK Tool Docs
xxxxx@microsoft.com

“Shahar Talmi” wrote in message news:xxxxx@ntdev…
> Hi,
> I am planning to use IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS in one of my
> drivers and I noticed that the MSDN docs state that this IOCTL requires
> Windows XP.
> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/fileio/bas
> e/ioctl_volume_get_volume_disk_extents.asp).
>
> The weird thing is that I found another document that states that this
> IOCTL
> is introduced in Windows 2K.
> (http://www.microsoft.com/whdc/devtools/ifskit/ntupto2k.mspx).
>
> I also found another document that states this IOCTL will work even on
> Windows NT 4.0.
> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnappcom/h
> tml/win2000appcomp.asp).
>
> So I’m confused. I tested this myself on Win2K and WinXP and as far as I
> can
> tell this IOCTL works on both platforms. There is, however, the exception
> of
> removable storage (the IOCTL is supported for removable storage only on
> WinXP), but I can live with that.
>
> So what I’m actually asking is - Is it safe to assume that the MSDN is
> wrong
> and this IOCTL is supported for non-removable storage on both Win2K and
> WinXP?
>
> Thanks,
> Shahar.
>
>
>

3

Thank you June,
During my tests of using this IOCTL I’ve discovered that it will not work
for Removable Storage on Win2K.
I think this should also be documented.

Thanks,
Shahar

-----Original Message-----
From: xxxxx@lists.osr.com
[mailto:xxxxx@lists.osr.com] On Behalf Of June Blender (MSFT)
Sent: Friday, December 17, 2004 6:26 PM
To: Windows System Software Devs Interest List
Subject: Re:[ntdev] MSDN docs mistake ?

Thanks for the feedback, Shahar!

This is an SDK doc. The DDK description of this IOCTL doesn’t have this
restriction. I’ve notified the SDK doc manager.

If you ever find a doc problem, scroll to the bottom of the doc page and
click the link to provide feedback.

– In the SDK, use the “What did you think of this topic?” link.
– In the DDK, use the “Send feedback on this topic.” link.

Oh, and you can use these to send compliments and suggestions, too.

Thanks,
June

June Blender (MSFT)
DDK Tool Docs
xxxxx@microsoft.com

“Shahar Talmi” wrote in message news:xxxxx@ntdev…
> Hi,
> I am planning to use IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS in one of my
> drivers and I noticed that the MSDN docs state that this IOCTL
> requires Windows XP.
> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/file
> io/bas e/ioctl_volume_get_volume_disk_extents.asp).
>
> The weird thing is that I found another document that states that this
> IOCTL is introduced in Windows 2K.
> (http://www.microsoft.com/whdc/devtools/ifskit/ntupto2k.mspx).
>
> I also found another document that states this IOCTL will work even on
> Windows NT 4.0.
> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnap
> pcom/h
> tml/win2000appcomp.asp).
>
> So I’m confused. I tested this myself on Win2K and WinXP and as far as
> I can tell this IOCTL works on both platforms. There is, however, the
> exception of removable storage (the IOCTL is supported for removable
> storage only on WinXP), but I can live with that.
>
> So what I’m actually asking is - Is it safe to assume that the MSDN is
> wrong and this IOCTL is supported for non-removable storage on both
> Win2K and WinXP?
>
> Thanks,
> Shahar.
>
>
>

—
Questions? First check the Kernel Driver FAQ at
http://www.osronline.com/article.cfm?id=256

You are currently subscribed to ntdev as: xxxxx@safend.com To unsubscribe
send a blank email to xxxxx@lists.osr.com

4

Thanks for the report, Shahar. I’ve forwarded your comments to the
responsible devs.

Again, I encourage you to use the feedback links in the SDK and DDK.

Thanks,
JuneB

–
June Blender (MSFT)
DDK Tool Docs
xxxxx@microsoft.com

“Shahar Talmi” wrote in message news:xxxxx@ntdev…
> Thank you June,
> During my tests of using this IOCTL I’ve discovered that it will not work
> for Removable Storage on Win2K.
> I think this should also be documented.
>
> Thanks,
> Shahar
>
> -----Original Message-----
> From: xxxxx@lists.osr.com
> [mailto:xxxxx@lists.osr.com] On Behalf Of June Blender
> (MSFT)
> Sent: Friday, December 17, 2004 6:26 PM
> To: Windows System Software Devs Interest List
> Subject: Re:[ntdev] MSDN docs mistake ?
>
> Thanks for the feedback, Shahar!
>
> This is an SDK doc. The DDK description of this IOCTL doesn’t have this
> restriction. I’ve notified the SDK doc manager.
>
> If you ever find a doc problem, scroll to the bottom of the doc page and
> click the link to provide feedback.
>
> – In the SDK, use the “What did you think of this topic?” link.
> – In the DDK, use the “Send feedback on this topic.” link.
>
> Oh, and you can use these to send compliments and suggestions, too.
>
> Thanks,
> June
>
> June Blender (MSFT)
> DDK Tool Docs
> xxxxx@microsoft.com
>
>
> “Shahar Talmi” wrote in message news:xxxxx@ntdev…
>> Hi,
>> I am planning to use IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS in one of my
>> drivers and I noticed that the MSDN docs state that this IOCTL
>> requires Windows XP.
>> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/file
>> io/bas e/ioctl_volume_get_volume_disk_extents.asp).
>>
>> The weird thing is that I found another document that states that this
>> IOCTL is introduced in Windows 2K.
>> (http://www.microsoft.com/whdc/devtools/ifskit/ntupto2k.mspx).
>>
>> I also found another document that states this IOCTL will work even on
>> Windows NT 4.0.
>> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnap
>> pcom/h
>> tml/win2000appcomp.asp).
>>
>> So I’m confused. I tested this myself on Win2K and WinXP and as far as
>> I can tell this IOCTL works on both platforms. There is, however, the
>> exception of removable storage (the IOCTL is supported for removable
>> storage only on WinXP), but I can live with that.
>>
>> So what I’m actually asking is - Is it safe to assume that the MSDN is
>> wrong and this IOCTL is supported for non-removable storage on both
>> Win2K and WinXP?
>>
>> Thanks,
>> Shahar.
>>
>>
>>
>
>
>
> —
> Questions? First check the Kernel Driver FAQ at
> http://www.osronline.com/article.cfm?id=256
>
> You are currently subscribed to ntdev as: xxxxx@safend.com To unsubscribe
> send a blank email to xxxxx@lists.osr.com
>
>
>

5

Shahar, according to the devs, the IOCTL was implemented in W2K, but only
for volumes residing on fixed disks. It does not work on removable media
drives, because they are not managed by the Volume Manager drivers.

I’ve reported this limitation to the doc team. Thanks again.

June Blender (MSFT)
DDK Tool Docs
xxxxx@microsoft.com

“Shahar Talmi” wrote in message news:xxxxx@ntdev…
> Thank you June,
> During my tests of using this IOCTL I’ve discovered that it will not work
> for Removable Storage on Win2K.
> I think this should also be documented.
>
> Thanks,
> Shahar
>
> -----Original Message-----
> From: xxxxx@lists.osr.com
> [mailto:xxxxx@lists.osr.com] On Behalf Of June Blender
> (MSFT)
> Sent: Friday, December 17, 2004 6:26 PM
> To: Windows System Software Devs Interest List
> Subject: Re:[ntdev] MSDN docs mistake ?
>
> Thanks for the feedback, Shahar!
>
> This is an SDK doc. The DDK description of this IOCTL doesn’t have this
> restriction. I’ve notified the SDK doc manager.
>
> If you ever find a doc problem, scroll to the bottom of the doc page and
> click the link to provide feedback.
>
> – In the SDK, use the “What did you think of this topic?” link.
> – In the DDK, use the “Send feedback on this topic.” link.
>
> Oh, and you can use these to send compliments and suggestions, too.
>
> Thanks,
> June
>
> June Blender (MSFT)
> DDK Tool Docs
> xxxxx@microsoft.com
>
>
> “Shahar Talmi” wrote in message news:xxxxx@ntdev…
>> Hi,
>> I am planning to use IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS in one of my
>> drivers and I noticed that the MSDN docs state that this IOCTL
>> requires Windows XP.
>> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/file
>> io/bas e/ioctl_volume_get_volume_disk_extents.asp).
>>
>> The weird thing is that I found another document that states that this
>> IOCTL is introduced in Windows 2K.
>> (http://www.microsoft.com/whdc/devtools/ifskit/ntupto2k.mspx).
>>
>> I also found another document that states this IOCTL will work even on
>> Windows NT 4.0.
>> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnap
>> pcom/h
>> tml/win2000appcomp.asp).
>>
>> So I’m confused. I tested this myself on Win2K and WinXP and as far as
>> I can tell this IOCTL works on both platforms. There is, however, the
>> exception of removable storage (the IOCTL is supported for removable
>> storage only on WinXP), but I can live with that.
>>
>> So what I’m actually asking is - Is it safe to assume that the MSDN is
>> wrong and this IOCTL is supported for non-removable storage on both
>> Win2K and WinXP?
>>
>> Thanks,
>> Shahar.
>>
>>
>>
>
>
>
> —
> Questions? First check the Kernel Driver FAQ at
> http://www.osronline.com/article.cfm?id=256
>
> You are currently subscribed to ntdev as: xxxxx@safend.com To unsubscribe
> send a blank email to xxxxx@lists.osr.com
>
>
>

6

IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS is present in the old w2k DDK
headers, and MSDN Library’s DDK chapter does not mention it to be XP-and-later.

Maxim Shatskih, Windows DDK MVP
StorageCraft Corporation
xxxxx@storagecraft.com
http://www.storagecraft.com

----- Original Message -----
From: “June Blender (MSFT)”
Newsgroups: ntdev
To: “Windows System Software Devs Interest List”
Sent: Monday, December 20, 2004 11:35 PM
Subject: Re:[ntdev] MSDN docs mistake ?

> Shahar, according to the devs, the IOCTL was implemented in W2K, but only
> for volumes residing on fixed disks. It does not work on removable media
> drives, because they are not managed by the Volume Manager drivers.
>
> I’ve reported this limitation to the doc team. Thanks again.
>
>
> June Blender (MSFT)
> DDK Tool Docs
> xxxxx@microsoft.com
>
>
> “Shahar Talmi” wrote in message news:xxxxx@ntdev…
> > Thank you June,
> > During my tests of using this IOCTL I’ve discovered that it will not work
> > for Removable Storage on Win2K.
> > I think this should also be documented.
> >
> > Thanks,
> > Shahar
> >
> > -----Original Message-----
> > From: xxxxx@lists.osr.com
> > [mailto:xxxxx@lists.osr.com] On Behalf Of June Blender
> > (MSFT)
> > Sent: Friday, December 17, 2004 6:26 PM
> > To: Windows System Software Devs Interest List
> > Subject: Re:[ntdev] MSDN docs mistake ?
> >
> > Thanks for the feedback, Shahar!
> >
> > This is an SDK doc. The DDK description of this IOCTL doesn’t have this
> > restriction. I’ve notified the SDK doc manager.
> >
> > If you ever find a doc problem, scroll to the bottom of the doc page and
> > click the link to provide feedback.
> >
> > – In the SDK, use the “What did you think of this topic?” link.
> > – In the DDK, use the “Send feedback on this topic.” link.
> >
> > Oh, and you can use these to send compliments and suggestions, too.
> >
> > Thanks,
> > June
> >
> > June Blender (MSFT)
> > DDK Tool Docs
> > xxxxx@microsoft.com
> >
> >
> > “Shahar Talmi” wrote in message news:xxxxx@ntdev…
> >> Hi,
> >> I am planning to use IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS in one of my
> >> drivers and I noticed that the MSDN docs state that this IOCTL
> >> requires Windows XP.
> >> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/file
> >> io/bas e/ioctl_volume_get_volume_disk_extents.asp).
> >>
> >> The weird thing is that I found another document that states that this
> >> IOCTL is introduced in Windows 2K.
> >> (http://www.microsoft.com/whdc/devtools/ifskit/ntupto2k.mspx).
> >>
> >> I also found another document that states this IOCTL will work even on
> >> Windows NT 4.0.
> >> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnap
> >> pcom/h
> >> tml/win2000appcomp.asp).
> >>
> >> So I’m confused. I tested this myself on Win2K and WinXP and as far as
> >> I can tell this IOCTL works on both platforms. There is, however, the
> >> exception of removable storage (the IOCTL is supported for removable
> >> storage only on WinXP), but I can live with that.
> >>
> >> So what I’m actually asking is - Is it safe to assume that the MSDN is
> >> wrong and this IOCTL is supported for non-removable storage on both
> >> Win2K and WinXP?
> >>
> >> Thanks,
> >> Shahar.
> >>
> >>
> >>
> >
> >
> >
> > —
> > Questions? First check the Kernel Driver FAQ at
> > http://www.osronline.com/article.cfm?id=256
> >
> > You are currently subscribed to ntdev as: xxxxx@safend.com To unsubscribe
> > send a blank email to xxxxx@lists.osr.com
> >
> >
> >
>
>
>
> —
> Questions? First check the Kernel Driver FAQ at
http://www.osronline.com/article.cfm?id=256
>
> You are currently subscribed to ntdev as: xxxxx@storagecraft.com
> To unsubscribe send a blank email to xxxxx@lists.osr.com
>

7

I just found out that Service Pack 4 for Windows 2000 includes a fix that is
designed to resolve this. You can download it from here:

http://www.microsoft.com/windows2000/downloads/servicepacks/sp4/default.asp

Please let me know if this doesn’t work.

–
June Blender (MSFT)
DDK Tool Docs
xxxxx@microsoft.com

“Shahar Talmi” wrote in message news:xxxxx@ntdev…
> Thank you June,
> During my tests of using this IOCTL I’ve discovered that it will not work
> for Removable Storage on Win2K.
> I think this should also be documented.
>
> Thanks,
> Shahar
>
> -----Original Message-----
> From: xxxxx@lists.osr.com
> [mailto:xxxxx@lists.osr.com] On Behalf Of June Blender
> (MSFT)
> Sent: Friday, December 17, 2004 6:26 PM
> To: Windows System Software Devs Interest List
> Subject: Re:[ntdev] MSDN docs mistake ?
>
> Thanks for the feedback, Shahar!
>
> This is an SDK doc. The DDK description of this IOCTL doesn’t have this
> restriction. I’ve notified the SDK doc manager.
>
> If you ever find a doc problem, scroll to the bottom of the doc page and
> click the link to provide feedback.
>
> – In the SDK, use the “What did you think of this topic?” link.
> – In the DDK, use the “Send feedback on this topic.” link.
>
> Oh, and you can use these to send compliments and suggestions, too.
>
> Thanks,
> June
>
> June Blender (MSFT)
> DDK Tool Docs
> xxxxx@microsoft.com
>
>
> “Shahar Talmi” wrote in message news:xxxxx@ntdev…
>> Hi,
>> I am planning to use IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS in one of my
>> drivers and I noticed that the MSDN docs state that this IOCTL
>> requires Windows XP.
>> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/file
>> io/bas e/ioctl_volume_get_volume_disk_extents.asp).
>>
>> The weird thing is that I found another document that states that this
>> IOCTL is introduced in Windows 2K.
>> (http://www.microsoft.com/whdc/devtools/ifskit/ntupto2k.mspx).
>>
>> I also found another document that states this IOCTL will work even on
>> Windows NT 4.0.
>> (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnap
>> pcom/h
>> tml/win2000appcomp.asp).
>>
>> So I’m confused. I tested this myself on Win2K and WinXP and as far as
>> I can tell this IOCTL works on both platforms. There is, however, the
>> exception of removable storage (the IOCTL is supported for removable
>> storage only on WinXP), but I can live with that.
>>
>> So what I’m actually asking is - Is it safe to assume that the MSDN is
>> wrong and this IOCTL is supported for non-removable storage on both
>> Win2K and WinXP?
>>
>> Thanks,
>> Shahar.
>>
>>
>>
>
>
>
> —
> Questions? First check the Kernel Driver FAQ at
> http://www.osronline.com/article.cfm?id=256
>
> You are currently subscribed to ntdev as: xxxxx@safend.com To unsubscribe
> send a blank email to xxxxx@lists.osr.com
>
>
>