DirectoryWatch.h

Go to the documentation of this file.

/*  DirectoryWatch.h - encapsulates ReadDirectoryChangesW.

    Copyright (C) 2001-2004 Mark Weaver
    Written by Mark Weaver <mark@npsl.co.uk>

    Part of the Open-Win32 library.
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA  02111-1307, USA.
*/

#ifndef OW32_DirectoryWatch_h
#define OW32_DirectoryWatch_h

#include <OW32/IoCompletion.h>
#include <OW32/RefCounted.h>
#include <OW32/auto_array_ptr.h>
#include <OW32/SyncObjects.h>

#include <stl/ci_string.h>

namespace OW32
{

class CIoCompletionThreadPool;
class CDirectoryWatchCallback;

class CDirectoryWatch : 
    public CIoCompletion, 
    public CRefCounted
{
public:
    IMPLEMENT_IO_COMPLETION(CDirectoryWatch);

    CDirectoryWatch(
        CDirectoryWatchCallback *callback,
        CIoCompletionThreadPool &ioCompletionPool,
        const ci_wstring        &directoryName,
        DWORD                   changesMask = FILE_NOTIFY_CHANGE_LAST_WRITE|FILE_NOTIFY_CHANGE_FILE_NAME
    );

    virtual ~CDirectoryWatch();

    const ci_wstring &getDirectory() const { return m_directory; }

    void cancel();

private:
    // No copy or assignment
    CDirectoryWatch(const CDirectoryWatch &other);
    CDirectoryWatch &operator= (const CDirectoryWatch &other);

    void OnWatchCompletion(BOOL bRet, DWORD dwBytes, LPOVERLAPPED lpOS);

    void processNotifications();

    CDirectoryWatchCallback *m_callback;

    ci_wstring              m_directory;

    DWORD                   m_changesMask;
    
    OVERLAPPEDPLUS          m_os;

    auto_array_ptr<BYTE>    m_notifyBuffer;

    DWORD                   m_notifyBufferCount;

    CCriticalSection        m_directoryLock;

    XHANDLE                 m_hDirectory;
};

#ifdef _MSC_VER
#pragma warning(default: 4251)
#endif

typedef CAutoRefCountedPtr<CDirectoryWatch> CDirectoryWatchPtr;

} // namespace OW32

#endif // OW32_DirectoryWatch_h

---