From 9026073a419b5ef68fb46d4f7fae52dbef09dbe1 Mon Sep 17 00:00:00 2001 From: Barry Golden Date: Thu, 6 Aug 2015 20:06:07 -0700 Subject: Remove obsolete readme.htm files --- storage/class/cdrom/src/cdrom.htm | 86 --------- storage/class/classpnp/src/classpnp.htm | 273 ----------------------------- storage/class/disk/src/disk.htm | 42 ----- storage/filters/addfilter/src/addfiltr.htm | 245 -------------------------- storage/sfloppy/src/sfloppy.htm | 187 -------------------- storage/tools/spti/src/spti.htm | Bin 109034 -> 0 bytes 6 files changed, 833 deletions(-) delete mode 100644 storage/class/cdrom/src/cdrom.htm delete mode 100644 storage/class/classpnp/src/classpnp.htm delete mode 100644 storage/class/disk/src/disk.htm delete mode 100644 storage/filters/addfilter/src/addfiltr.htm delete mode 100644 storage/sfloppy/src/sfloppy.htm delete mode 100644 storage/tools/spti/src/spti.htm (limited to 'storage') diff --git a/storage/class/cdrom/src/cdrom.htm b/storage/class/cdrom/src/cdrom.htm deleted file mode 100644 index 483d3c85..00000000 --- a/storage/class/cdrom/src/cdrom.htm +++ /dev/null @@ -1,86 +0,0 @@ - - - - -CD ROM - - - -

CD ROM

- -

SUMMARY

-The CD ROM driver is used to provide access to CD, DVD and Blu-ray drives. It supports Plug and Play, Power Management, and AutoRun (media change notification). It is a 64-bit compliant driver. - -

BUILDING THE SAMPLE

-To build cdrom.sys, you must first set up the DDK/WDK environment on your host machine. The "Installation and Release Notes" in the Windows 2000/XP/Server 2003/Vista/Server 2008/Windows 7 DDK/WDK has a complete description on how to do this. -

- -Macro BLD invokes the Microsoft make routines that produce log file called buildxxx_yyy_zzz.log, and also buildxxx_yyy_zzz.wrn and buildxxx_yyy_zzz.err if there are any warnings or errors, where xxx stands for fre or chk depending on the environment chosen, yyy stands for the OS version (W2k, WXP, Wnet or Win7), and zzz stands for platform version (x86, ia64 or amd64). - -

If the build succeeds, the driver will be placed in the binary output directory specified for the build environment. You can get the output path from the buildxxx_yyy_zzz.log file. - -

INSTALLATION

-The in-box CD ROM driver is protected by the system, and thus a normal device driver update attempt through the Device Manager will fail. Users are not encouraged to replace the in-box CD ROM driver. The following work-around is provided in case there is a need, but the users are warned that this may harm the system. -

- -NOTE: After installation completes successfully, "mycdrom.sys" will be the effective driver for the device, "cdrom.sys" will no longer be used. - -

CODE TOUR

-

File Manifest

-
File			Description
-
-
-aacs.c			The CDROM class driver implementation of handling AACS IOCTLs
-autorun.c		Code for supporting media change detection in the cd/dvd driver
-cdrom.c			Main code base
-cdrom.h			Main header file for cdrom.sys
-cdrom.htm		This file
-cdrom.inf		The CDROM class driver configuration file
-cdrom.rc		Resource file
-cdromp.h		Private header file for cdrom.sys modules
-common.c		Shared private routines for cdrom.sys
-data.c			Global data definitions
-guid.c			GUIDs needed for cdrom.sys
-init.c			Initialization routines for cdrom.sys
-ioctl.c			Ioctl dispatch handlers
-ioctl.h			Ioctl dispatch handlers - header file
-makefile		Makefile
-makefile.inc		Makefile used to generate custom targets required by the module
-mmc.c			All functions related to MMC
-mmc.h			All functions related to MMC - header file
-pnppower.c		Functions to handle PnP and Power IRPs
-scratch.c		Functions for using common scratch buffer
-scratch.h		Functions for using common scratch buffer - header file
-sense.c			Functions needed to accurately determine how to retry requests on CDROM device types
-sources			Macro definitions that are recognized by the Build utility
-
-
-

Top of page

- - - -
-

- -

© 2008 Microsoft Corporation

- diff --git a/storage/class/classpnp/src/classpnp.htm b/storage/class/classpnp/src/classpnp.htm deleted file mode 100644 index 4c2b159e..00000000 --- a/storage/class/classpnp/src/classpnp.htm +++ /dev/null @@ -1,273 +0,0 @@ - - - - - - - - -ClassPnP - - - - - - - - - -
- -

ClassPnP

- -

Summary

- -

This is the library for -all storage drivers. It simplifies writing a storage driver by implementing 90 percent -of the code required to support Plug and Play, Power Management, et cetera. -This library is used by disk.sys, cdrom.sys -and the tape class drivers.

- -

No INF file is needed to -install this library. The library is 64-bit compliant.

- -

Building the Sample

- -

To build the sample, run build. -Once built, one binary will be created: classpnp.sys. -This sample is based on live source code, and only builds in the current OS -build environment. 

- -

CODE TOUR

- -

File Manifest

- -
File                   Description
 
Autorun.c              Media change notification (MCN) code
Class.c                Main code base
Class.rc               Resource file
Class.src              Exports
Classp.h               Private header
Classwmi.c             WMI functionality
Clntirp.c              Client IRP queuing code
Create.c               Create IRP code
Data.c                 Static driver data
Debug.c                Debug code and data
Debug.h                Debug header file
Dictlib.c              File system dictionary code
Lock.c                 Storage remove lock implementation
Makefile               Makefile
Obsolete.c             Obsolete code used by legacy drivers
Power.c                Power code
Retry.c                Transfer packet retry code
Sources                Sources file
Utils.c                Utility code
Xferpkt.c              Transfer packet processing code
 
 
- -

Top of page -

- -
 
- - - - - -
-

 

-
- -
 
 
- -

© -2004 Microsoft Corporation

- -
- - - - diff --git a/storage/class/disk/src/disk.htm b/storage/class/disk/src/disk.htm deleted file mode 100644 index bb77f1fd..00000000 --- a/storage/class/disk/src/disk.htm +++ /dev/null @@ -1,42 +0,0 @@ - - - - -Disk - - - -

Disk

- -

Summary

-The Disk sample is used with Classpnp.sys as disk driver. The sample supports Plug and Play, Power Management, WMI, and failure prediction (S.M.A.R.T.), and it is 64-bit compliant. - -

Building the Sample

-To build the sample, run the build command. Once built, this sample will create one binary: Disk.sys. - -

CODE TOUR

-

File Manifest

-
File			Description
-
-Data.c		List of workarounds for some drives (no code)
-Disk.c		Main code base
-Disk.h		Private header files
-Disk.rc		Resource file
-Diskwmi.c		S.M.A.R.T. WMI implementation
-Drivesup.c		No longer used
-Drivesup.h		No longer used
-Enum.c		Enumeration routines for disk drives
-Makefile		Makefile
-Pnp.c		Start/add/pnp code
-Sources		Sources
-
-
-

Top of page

- - - -
-

- -

© 1999 Microsoft Corporation

- diff --git a/storage/filters/addfilter/src/addfiltr.htm b/storage/filters/addfilter/src/addfiltr.htm deleted file mode 100644 index c5a6d676..00000000 --- a/storage/filters/addfilter/src/addfiltr.htm +++ /dev/null @@ -1,245 +0,0 @@ - - - - - - - - -Addfilter - - - - - - - -
- -

Addfilter

- -

SUMMARY

- -

Addfilter is a command-line application which -adds and removes filter drivers for a given drive or volume. It is intended to -demonstrate how to insert a filter driver into the driver stack of a device. -The sample illustrates how to do this by using the SetupDi -APIs. The sample works on the x86 platform. It has -only been tested in a 32-bit environment. Since Addfilter -is not a driver, it does not deal with Plug and Play or Power Management.

- -

No INF file is needed to -install this application.

- -

BUILDING THE SAMPLE

- -

Enter the checked or free -build environment. Then, while in the Addfilter -sample directory, type build. A successful build produces the executable -Addfilter.exe.

- -

RELEASE NOTES

- -

1. This initial sample -does not check the filter for validity before it is added to the driver stack. -If an invalid filter is added, the specified device may no longer be -accessible.

- -
- -

Important: If you attempt to add a -non-existent filter to a boot device and then reboot, the system may show the -error message INACCESSIBLE_BOOT_DEVICE. If this happens, you will be unable to -start the computer. To fix this, when the boot menu is displayed at startup, go -to the Advanced Options screen and select Use Last Known Good Profile.

- -
- -

If you attempt to add a -non-existent filter to a normal (non-boot) device (CD drive, floppy drive, -etc.), you will need to go into the Device Manager, uninstall the device, -reboot, and re-add the device from Add Hardware. Also, be careful not to add a -filter to a driver with which it is not designed to operate. Unpredictable -results may ensue.

- -

2. The sample is intended -for use with upper filter drivers only.

- -

3. When you add a filter -to a device, that device needs to be restarted. Depending on the device, this -may necessitate restarting your computer. The RestartDevice -function (in Addfilter.c) stops the specified device -and then restarts it. If the device has been stopped but not restarted, and the -machine is restarted, the reboot will not necessarily restart the device. You -will need to call the RestartDevice function -to restart your device.

- -

4. Since the sample -currently enumerates only disk devices, the sample can only operate on devices -of this class. One way in which you could extend this sample code is by adding -another command-line argument that handles other device types.

- -

5. The sample runs in -user mode only.

- -

Usage: addfilter -[/listdevices] [/device device_name] -[/add filter] [/remove filter]

- -

If the device name is not -supplied, settings will apply to all devices.

- -

If there is no /add or -/remove argument, a list of currently installed drivers will be printed.

- -

CODE TOUR

- -

File Manifest

- -
File           Description
 
Addfilter.c    Main source file
Addfilter.rc   Version resource file
Sources        Sources file
Makefile       Makefile
 
 
- -

Top of page -

- -
 
- - - - - -
-

 

-
- -
 
 
- -

© -2004 Microsoft Corporation

- -
- - - - diff --git a/storage/sfloppy/src/sfloppy.htm b/storage/sfloppy/src/sfloppy.htm deleted file mode 100644 index d46a7567..00000000 --- a/storage/sfloppy/src/sfloppy.htm +++ /dev/null @@ -1,187 +0,0 @@ - - - - - - - - -SFloppy - - - - - - - -
- -

Sfloppy

- -

SUMMARY

- -

The sfloppy -sample is a super floppy driver that resides in the directory -\\Ntddk\Src\Storage\sfloppy. It is a class driver for Super Floppy disk drives. -It sits a level above the port driver (ATAPI, USB, etc) in the driver stack, -and brokers communication between the application level and the port driver. -The floppy driver takes requests from filesystem -drivers and then sends the appropriate SCSI_REQUEST_BLOCK (SRB) to the port -driver. It is compatible with x86 and IA64 platforms.

- -

BUILDING THE SAMPLE

- -

Type build in the -\\Ntddk\Src\Storage\Sfloppy directory. A successful build produces sfloppy.sys

- -

CODE TOUR

- -

File Manifest

- -
File           Description
 
Floppy.c       Super Floppy diskette driver  
SFloppy.rc     Resource file
Sources        Sources for build
Sfloppy.inf    INF file super floppy driver
- -

 

- -

Top of page -

- -
 
- - - - - -
-

 

-
- -
 
 
- -

© -2004 Microsoft Corporation

- -
- - - - diff --git a/storage/tools/spti/src/spti.htm b/storage/tools/spti/src/spti.htm deleted file mode 100644 index 17da4a11..00000000 Binary files a/storage/tools/spti/src/spti.htm and /dev/null differ -- cgit v1.3.1