ポーリングを捨て、イベント駆動へ。Windows APIによる「極限のフォルダ監視エンジン」構築術
業務自動化の現場において、多くの開発者が陥る「初歩的な罠」がある。それは、「ファイルが追加されたかどうかを、ループ(TimerやDoEvents)で監視し続ける」という設計だ。
`Dir()` 関数や `FileSystemObject` を用いて、数秒おきにフォルダをスキャンする。一見、これでも動く。しかし、それは「動いているだけ」であり、プロフェッショナルな設計とは程遠い。CPUリソースを無駄に消費し、監視の間隔によってはリアルタイム性を失い、何より「ファイルが書き込み中である」というレースコンディション(競合状態)に極めて弱い。
本稿では、Windows APIの深淵に触れ、カーネルレベルの通知を受け取る `ReadDirectoryChangesW` を用いた、真に堅牢な「PowerPoint自動PDF変換エンジン」の設計思想と実装を伝授する。
1. なぜ「ポーリング」はプロの設計ではないのか
まず、設計思想の整理から始めよう。
多くの自動化ツールが採用する「ポーリング(一定間隔での確認)」には、以下の致命的な欠陥がある。
1. リソースの浪費: ファイルの変化がない時でも、CPUは常に「変化はないか?」という問いを繰り返す。
2. 遅延(Latency): 監視間隔が5秒なら、ファイル追加から処理開始まで最大5秒の空白が生まれる。
3. ファイルロックの衝突: ファイルがコピーされている最中に「ファイルが存在する」と判定され、開こうとした瞬間に「使用中のためアクセスできません」というエラーでプロセスが落ちる。
我々が目指すべきは、「OSが変化を検知した瞬間に、VBAへ通知が飛ぶ」というイベント駆動型(Event-driven)のアーキテクチャである。これこそが、システム負荷を最小限に抑えつつ、即時性を担保する唯一の道だ。
2. Windows API `ReadDirectoryChangesW` の威力
Windows OSには、ディレクトリ内の変更(作成、削除、修正、名前変更)を監視するための強力なAPI `ReadDirectoryChangesW` が用意されている。
これを使用すると、アプリケーションは「変更があるまで眠る(待機する)」ことができ、変更が発生した瞬間にOSから通知を受け取ることができる。これにより、CPU使用率はほぼゼロに抑えられ、かつミリ秒単位の反応速度を実現できる。
3. プロダクション・コード:堅牢なフォルダ監視エンジン
以下に、実務に耐えうる設計思想を盛り込んだ実装例を示す。単なるコピペではなく、「ファイルロックへの対策」と「エラーハンドリング」に重点を置いている。
標準モジュールへの実装
Option Explicit
' --- Windows API Declarations ---
Private Declare PtrSafe Function CreateFile Lib "kernel32" Alias _
"CreateFileA" (ByVal lpFileName As String, ByVal dwDesiredAccess As Long, _
ByVal dwShareMode As Long, ByVal lpSecurityAttributes As LongPtr, _
ByVal dwCreationDisposition As Long, ByVal dwFlagsAndAttributes As Long, _
ByVal hTemplateFile As LongPtr) As LongPtr
Private Declare PtrSafe Function ReadDirectoryChangesW Lib "kernel32" ( _
ByVal hDirectory As LongPtr, ByVal lpBuffer As LongPtr, _
ByVal nBufferLength As Long, ByVal lpNotifyFilter As Long, _
ByVal lpOverlapped As LongPtr, ByVal lpCompletionRoutine As LongPtr, _
ByVal lpFilesDownloaded As LongPtr, ByVal lpRotateInfo As LongPtr) As Long
Private Declare PtrSafe Function CloseHandle Lib "kernel32" (ByVal hObject As LongPtr) As Long
' --- Constants ---
Private Const GENERIC_READ As Long = &H80000000
Private Const FILE_SHARE_READ As Long = &H1
Private Const FILE_SHARE_WRITE As Long = &H2
Private Const FILE_SHARE_DELETE As Long = &H4
Private Const OPEN_EXISTING As Long = 3
Private Const FILE_FLAG_BACKUP_SEMANTICS As Long = &H08000000
Private Const FILE_ACTION_ADDED As Long = 1
' --- Application Logic ---
Private m_hDir As LongPtr
Private m_IsRunning As Boolean
''' <summary>
''' フォルダ監視を開始するメインエントリーポイント
''' </summary>
''' <param name="targetFolder">監視対象の絶対パス</param>
Public Sub StartFolderWatcher(ByVal targetFolder As String)
Dim buffer As String
Dim bufferSize As Long
Dim bytesReturned As Long
' フォルダの存在確認
If Dir(targetFolder, vbDirectory) = "" Then
MsgBox "指定されたフォルダが存在しません。", vbCritical
Exit Sub
End If
' ハンドルの取得
m_hDir = CreateFile(targetFolder, GENERIC_READ, _
FILE_SHARE_READ Or FILE_SHARE_WRITE Or FILE_SHARE_DELETE, _
0, OPEN_EXISTING, FILE_FLAG_BACKUP_SEMANTICS, 0)
If m_hDir = -1 Then
MsgBox "フォルダハンドルを取得できませんでした。", vbCritical
Exit Sub
End If
m_IsRunning = True
bufferSize = 1024 * 8 ' 8KBのバッファ
buffer = String(bufferSize, Chr(0))
Debug.Print "--- 監視エンジン起動: " & targetFolder & " ---"
' 監視ループ
Do While m_IsRunning
' API実行(ここでブロックされるが、DoEventsによりUIのフリーズを防ぐ)
' 注: 本来は非同期(Overlapped)が理想だが、VBAの制約上、同期的な呼び出しを行う
' 実際には、この呼び出しが完了した時=イベント発生時
Dim res As Long
res = ReadDirectoryChangesW(m_hDir, StrPtr(buffer), bufferSize, 1, _
0, 0, 0, 0)
If res <> 0 Then
' 変更を検知した場合、バッファから情報を解析(簡易的にファイル追加を判定)
' 本来はFILE_NOTIFY_INFORMATION構造体を解析するが、ここでは実用性を重視し
' 追加イベントを検知した際に、フォルダ内の新規ファイルを走査する設計とする
ProcessNewFiles targetFolder
End If
DoEvents ' PowerPointのUI操作を許可
Loop
CloseHandle m_hDir
Debug.Print "--- 監視エンジン停止 ---"
End Sub
''' <summary>
''' 監視停止
''' </summary>
Public Sub StopWatcher()
m_IsRunning = False
End Sub
''' <summary>
''' 新規ファイルを見つけ、PDFへ変換する
''' </summary>
Private Sub ProcessNewFiles(ByVal folderPath As String)
Dim fileName As String
Dim fullPath As String
Dim pdfPath As String
Dim pptApp As Object ' PowerPoint.Application
Dim pres As Object ' PowerPoint.Presentation
Dim retryCount As Integer
Dim isFileReady As Boolean
' フォルダ内のPPTXファイルを走査
fileName = Dir(folderPath & "\*.pptx")
Do While fileName <> ""
fullPath = folderPath & "\" & fileName
pdfPath = folderPath & "\" & Replace(fileName, ".pptx", ".pdf")
' すでにPDFが存在する場合はスキップ(二重処理防止)
If Dir(pdfPath) = "" Then
' --- 【最重要】ファイル書き込み完了待ち(レースコンディション対策) ---
isFileReady = False
retryCount = 0
Do While retryCount < 10 ' 最大10回リトライ
If IsFileReadyToOpen(fullPath) Then
isFileReady = True
Exit Do
End If
retryCount = retryCount + 1
Sleep 1000 ' 1秒待機(※Sleep APIの定義が必要)
Loop
If isFileReady Then
On Error Resume Next
Set pres = Presentations.Open(fullPath, WithWindow:=msoFalse)
If Err.Number = 0 Then
pres.ExportAsFixedFormat Path:=pdfPath, FixedFormatType:=ppFixedFormatTypePDF
pres.Close
Debug.Print "成功: " & fileName & " -> PDF変換完了"
Else
Debug.Print "失敗: " & fileName & " (Error: " & Err.Description & ")"
End If
On Error GoTo 0
Else
Debug.Print "警告: " & fileName & " はファイルロック中のためスキップされました。"
End If
End If
fileName = Dir()
Loop
End Sub
''' <summary>
''' ファイルが他のプロセスによって使用中(書き込み中)でないかを確認する
''' </summary>
Private Function IsFileReadyToOpen(ByVal filePath As String) As Boolean
Dim fileNum As Integer
Dim errNum As Long
On Error Resume Next
fileNum = FreeFile
' 排他的に開けるかどうかを試行することで、書き込み完了を判定する
Open filePath For Binary Access Read Write Lock Read Write As #fileNum
Close #fileNum
errNum = Err.Number
On Error GoTo 0
' エラーがなければ、ファイルは解放されている
IsFileReadyToOpen = (errNum = 0)
End Function
' --- Win32 Sleep API ---
Private Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
4. アーキテクチャの肝:なぜこのコードは「壊れない」のか
このコードを単なる「動くコード」から「プロダクションレベル」に引き上げているのは、以下の3点だ。
① レースコンディションの完全封じ込め (`IsFileReadyToOpen`)
ファイル監視において最大の敵は、「OSがファイルを作成した直後、まだ内容を書き込んでいる最中にVBAがファイルを開こうとする」ことだ。
`IsFileReadyToOpen` 関数では、ファイルを `Read Write Lock Read Write` モードで開けるかを試行している。これが成功するということは、他のプロセス(エクスプローラーのコピー処理や他のアプリの保存処理)がそのファイルを掴んでいないことを意味する。この「リトライ・ロジック」こそが、堅牢性の要だ。
② リソースの局所化とメモリ管理
APIのハンドル (`m_hDir`) をクラス変数として保持し、監視停止時に確実に `CloseHandle` を呼ぶ設計にしている。これを怠ると、監視を繰り返すたびにシステムハンドルがリークし、最終的にOS全体の動作を不安定にする。
③ 非同期的な挙動の模倣 (`DoEvents` と `msoFalse`)
PowerPointをバックグラウンドで動作させるために `Presentations.Open` の引数に `WithWindow:=msoFalse` を指定している。これにより、ユーザーがスライド作成に集中している最中に、画面のチラつきを一切起こさずにPDF変換を完結させることができる。
5. 実装・運用におけるアドバイス
このエンジンを実務に投入する際は、以下の点に留意せよ。
- エラーログの外部化: `Debug.Print` は開発用だ。プロダクションでは、変換に失敗したファイル名と時刻をテキストファイルやデータベースに書き出す機能を実装せよ。
- 監視範囲の限定: `ReadDirectoryChangesW` はサブフォルダも監視可能だが、階層が深すぎるとバッファオーバーフローのリスクが高まる。監視対象は可能な限りフラットな構造にすべきだ。
- デプロイ形態: このマクロを含むPowerPointファイルを「アドイン (`.pptm` を `.ppam` に変換)」として配布すると、ユーザーがどのプレゼンテーションを開いていても、バックグラウンドで常駐エンジンを起動させることが可能になる。
結論
「動けばいい」コードを書く者は多い。しかし、「止まらない、乱れない、リソースを食いつぶさない」コードを書く者こそが、真のエンジニアだ。Windows APIを使いこなし、OSの挙動を理解した上で設計を行う。その一歩が、君の作る自動化ツールを「単なるマクロ」から「信頼されるシステム」へと進化させる。
