File System Stream Handler Modules

The following figure illustrates the outline of the file system stream handler (FSSHT.DLL).
The descriptions for the sample file system stream handler modules shown in the example in section File System Stream Handler Modules are contained in the following table.
кФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
ГProcedure Name ГDescription                                            Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHINIT.C       ГReceives control when FSSHT.DLL is loaded and performs Г
Г               Гthe following functions:                               Г
Г               ГDLL_INITTERM  Initialization routine to                Г
Г               Г              register the stream handler              Г
Г               Г              with the Sync/Stream Manager             Г
Г               Г              (SSM), allocate heap memory,             Г
Г               Г              and create mutex semaphores.             Г
Г               ГSHEXITLIST    Termination routine to                   Г
Г               Г              deregister the stream handler,           Г
Г               Г              destroy any active streams,              Г
Г               Г              reload heap memory, and close            Г
Г               Г              mutex semaphores.                        Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHROUTER.C     ГReceives the stream handler command (SHC) messages fromГ
Г               ГSSM and routes them to the appropriate low-level       Г
Г               Гroutines.                                              Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГFSSHASS.C      ГProcesses the SHC_ASSOCIATE stream handler command     Г
Г               Гmessage to associate an object (file handler, CD ROM   Г
Г               Гdrive letter, and so on) with a data stream.           Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHEPROT.C      ГProcesses the SHC_ENUMERATE stream handler command     Г
Г               Гmessage to return a list of stream protocols for a     Г
Г               Гgiven stream.                                          Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHGPROT.C      ГProcesses the SHC_GET_PROTOCOL stream handler command  Г
Г               Гmessage to return a stream protocol control block      Г
Г               Г(SPCB) for a given data type.                          Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHIPROT.C      ГProcesses the SHC_INSTALL_PROTOCOL stream handler      Г
Г               Гcommand message to install or replace an SPCB for a    Г
Г               Гgiven data type.                                       Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГFSSHCREA.C     ГProcesses the SHC_CREATE stream handler command messageГ
Г               Гto create a stream instance for a given data type and  Г
Г               Гsubtype. If the create is for a source stream handler, Г
Г               Гa read thread in FSSHREAD.C is created. Otherwise a    Г
Г               Гwrite thread is created in FSSHWRIT.C for a target     Г
Г               Гstream handler.                                        Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHNEGOT.C      ГProcesses the SHC_NEGOTIATE_RESULTS stream handler     Г
Г               Гcommand message to save the negotiated SPCB for a givenГ
Г               Гstream instance.                                       Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHSTART.C      ГProcesses the SHC_START stream handler command message Г
Г               Гto start the data streaming for a given stream         Г
Г               Гinstance. For a source stream handler, the read thread Г
Г               Гin FSSHREAD.C is run. For a target stream handler, the Г
Г               Гwrite thread in FSSHWRIT.C is run.                     Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHSTOP.C       ГProcesses the SHC_STOP stream handler command message  Г
Г               Гto stop the data streaming for a given stream instance.Г
Г               ГFor a source stream handler, the read thread in all theГ
Г               Гbuffers is either discarded (STOP DISCARD) or returned Г
Г               Гto SSM (STOP FLUSH). For a target stream handler, the  Г
Г               Гwrite thread in FSSHWRIT.C is blocked, with buffers    Г
Г               Гeither discarded or flushed.                           Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГFSSHSEEK.C     ГProcesses the SHC_SEEK stream handler command message  Г
Г               Гto seek to a specified point in the stream object. The Г
Г               Гseek can be from the beginning of the file, the currentГ
Г               Гposition, or the end o the file. The seek point can be Г
Г               Гspecified in bytes offset or MMTIME units. This module Г
Г               Гinterfaces with low-level routines in SEEKCALC.ASM to  Г
Г               Гperform conversion from MMTIME values to bytes, and    Г
Г               Гwith mmioSeek to perform the actual seek in the object.Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSEEKCALC.ASM   ГPerforms the low-level conversions of MMTIME to bytes, Г
Г               Гand bytes to MMTIME, needed by FSSHSEEK.C.             Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHDESTRY.C     ГProcesses the SHC_DESTROY stream handler command       Г
Г               Гmessage to remove a stream instance. Either the read   Г
Г               Гthread in FSSHREAD.C or the write thread in FSSHWRIT.C Г
Г               Гis terminated when this message is received.           Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHMISC.C       ГSupporting routines used by the other stream handler   Г
Г               Гmodules; for example, searching the stream instance    Г
Г               Гchain to find a particular stream instance, finding an Г
Г               Гextended stream protocol control block (SPCB), and     Г
Г               Гdeallocating a stream instance.                        Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГFSSHREAD.C     ГReads an object from the file system. A read thread is Г
Г               Гcreated when the SHC_CREATE message is received in     Г
Г               ГFSSHCREA.C and destroyed when the SHC_DESTROY message  Г
Г               Гis received in SHDESTRY.C. The read is accomplished by Г
Г               Гinterfacing with a mmioRead routine and low-level      Г
Г               Гroutines in SHIOUTIL.C to check processing flags and   Г
Г               Гreport events to SSM.                                  Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSHIOUTIL.C     ГLow-level routines used by FSSHREAD.C and FSSHWRIT.C   Г
Г               Гmodules. This module performs checks of processing     Г
Г               Гflags and also reports processing events to SSM.       Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГFSSHDAT.C      ГGlobal data declaration for the stream handler         Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Гmakefile       ГMakefile to build FSSHT.DLL sample file system stream  Г
Г               Гhandler                                                Г
РФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
[Back] [Next]