FSDK
Programming Interface V2.4
Doc-To-Help Standard Manual
November 2006
OSR Open Systems Resources, Inc.
105 Route
101A, Suite 19
Amherst, New
Hampshire 03031-2277
(603) 595-6500
¨ FAX: (603) 595-6503
© 1997-2005 OSR Open Systems
Resources, Inc.
All rights
reserved. No part of this work covered
by the copyright hereon may be reproduced or used in any form or by any means
-- graphic, electronic, or mechanical, including photocopying, recording,
taping, or information storage and retrieval systems -- without written
permission of OSR Open Systems Resources, Inc., 105 Route 101A Suite 19, Amherst,
New Hampshire 03031, (603) 595-6500
OSR, the
traditional OSR Logo, the new OSR logo, “OSR Open Systems Resources, Inc.”, and
“The NT Insider” are trademarks of OSR Open Systems Resources, Inc. All other trademarks mentioned herein are the
property of their owners.
Printed in the United States of America
Part Number FSDK-DOC-PM-UN285-01
LIMITED WARRANTY
OSR Open Systems
Resources, Inc. (OSR) expressly disclaims any warranty for the information
presented herein. This material is
presented “as is” without warranty of any kind, either express or implied,
including, without limitation, the implied warranties of merchantability or
fitness for a particular purpose. The
entire risk arising from the use of this material remains with you. OSR’s entire liability and your exclusive
remedy shall not exceed the price paid for this material. In no event shall OSR or its suppliers be
liable for any damages whatsoever (including, without limitation, damages for
loss of business profit, business interruption, loss of business information,
or any other pecuniary loss) arising out of the use or inability to use this
information, even if OSR has been advised of the possibility of such
damages. Because some
states/jurisdictions do not allow the exclusion or limitation of liability for
consequential or incidental damages, the above limitation may not apply to you.
U.S. GOVERNMENT
RESTRICTED RIGHTS
This material is
provided with RESTRICTED RIGHTS. Use,
duplication, or disclosure by the Government is subject to restrictions as set
forth in subparagraph (c)(1)(ii) of The Right in Technical Data and Computer
Software clause at DFARS 252.227-7013
or subparagraphs (c)(1) and (2) of the Commercial Computer Software--Restricted
Rights 48 CFR 52.227-19, as
applicable. Manufacturer is OSR Open
Systems Resources, Inc. Amherst, New Hampshire 03031.
Contents
Introduction 1
Executive Overview.................................................................................................................................. 1
Conventions.............................................................................................................................................. 1
Status.......................................................................................................................................................... 2
Common Development Issues 3
Overview.................................................................................................................................................... 3
Handles and Handle Management......................................................................................................... 3
Accessing the IRP.................................................................................................................................... 4
Managing Upcalls.................................................................................................................................... 5
Caching...................................................................................................................................................... 5
Synchronization Changes....................................................................................................................... 6
Drive Letter Management........................................................................................................................ 6
Locking Considerations........................................................................................................................... 7
Attribute Operations................................................................................................................................ 7
FSDK Support Interface 8
Overview.................................................................................................................................................... 8
Wrapper Support Routines..................................................................................................................... 8
OwAllocateSDBuffer................................................................................................................ 9
OwDeregister........................................................................................................................... 10
OwDisableFileCache.............................................................................................................. 11
OwDisableVolumeCache....................................................................................................... 12
OwEnableFileCache................................................................................................................ 13
OwEnableVolumeCache......................................................................................................... 14
OwFlushCache........................................................................................................................ 15
OwGetCharacteristics............................................................................................................. 16
OwGetDirectorySearchString................................................................................................ 17
OwGetFsdHandleForFileObject............................................................................................ 18
OwGetMediaDeviceObject.................................................................................................... 19
OwGetPseudoDeviceObject.................................................................................................. 20
OwGetTopLevelIrp................................................................................................................. 21
OwIoControl............................................................................................................................ 22
OwMediaRead......................................................................................................................... 23
OwMediaWrite........................................................................................................................ 24
OwNotifyDirectoryChange................................................................................................... 25
OwPostWork........................................................................................................................... 27
OwPurgeCache........................................................................................................................ 28
OwRegister.............................................................................................................................. 30