From 04ffb1657f7d8cebbb8be46834da435c68d29a1c Mon Sep 17 00:00:00 2001
From: Glenn Maynard <gmaynard@users.sourceforge.net>
Date: Sat, 10 Dec 2005 02:14:06 +0000
Subject: [PATCH] comments, fixes

---
 stepmania/src/arch/MemoryCard/MemoryCardDriver.h | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/stepmania/src/arch/MemoryCard/MemoryCardDriver.h b/stepmania/src/arch/MemoryCard/MemoryCardDriver.h
index 9c943ff013..10edbc95ac 100644
--- a/stepmania/src/arch/MemoryCard/MemoryCardDriver.h
+++ b/stepmania/src/arch/MemoryCard/MemoryCardDriver.h
@@ -84,9 +84,14 @@ public:
 	virtual bool DoOneUpdate( bool bMount, vector<UsbStorageDevice>& vStorageDevicesOut );
 
 protected:
+	/* This may be called before GetUSBStorageDevices; return false if the results of
+	 * GetUSBStorageDevices have not changed.  (This is an optimization.) */
+	virtual bool USBStorageDevicesChanged() { return true; }
 	virtual void GetUSBStorageDevices( vector<UsbStorageDevice>& vDevicesOut ) { }
-	virtual bool USBStorageDevicesChanged() { return false; }
-	bool TestWrite( UsbStorageDevice* pDevice ) { return true; }
+
+	/* Mount(pDevice) will has been called successfully.  Test the device.  On
+	 * failure, call pDevice->SetError() appropriately, and return false. */
+	virtual bool TestWrite( UsbStorageDevice* pDevice ) { return true; }
 
 private:
 	vector<UsbStorageDevice> m_vDevicesLastSeen;