ULONG	WINAPI	CH375DriverCommand(  // 直接傳遞命令給驅動程序,出錯則返回0,否則返回數據長度
	ULONG			iIndex,  // 指定CH375設備序號,V1.6以上DLL也可以是設備打開后的句柄
	mPWIN32_COMMAND	ioCommand );  // 命令結構的指針
// 該程序在調用后返回數據長度,并且仍然返回命令結構,如果是讀操作,則數據返回在命令結構中,
// 返回的數據長度在操作失敗時為0,操作成功時為整個命令結構的長度,例如讀一個字節,則返回mWIN32_COMMAND_HEAD+1,
// 命令結構在調用前,分別提供:管道號或者命令功能代碼,存取數據的長度(可選),數據(可選)
// 命令結構在調用后,分別返回:操作狀態代碼,后續數據的長度(可選),
//   操作狀態代碼是由WINDOWS定義的代碼,可以參考NTSTATUS.H,
//   后續數據的長度是指讀操作返回的數據長度,數據存放在隨后的緩沖區中,對于寫操作一般為0


ULONG	WINAPI	CH375GetDrvVersion( );  // 獲得驅動程序版本號,返回版本號,出錯則返回0


BOOL	WINAPI	CH375ResetDevice(  // 復位USB設備
	ULONG			iIndex );  // 指定CH375設備序號


BOOL	WINAPI	CH375GetDeviceDescr(  // 讀取設備描述符
	ULONG			iIndex,  // 指定CH375設備序號
	PVOID			oBuffer,  // 指向一個足夠大的緩沖區,用于保存描述符
	PULONG			ioLength );  // 指向長度單元,輸入時為準備讀取的長度,返回后為實際讀取的長度


BOOL	WINAPI	CH375GetConfigDescr(  // 讀取配置描述符
	ULONG			iIndex,  // 指定CH375設備序號
	PVOID			oBuffer,  // 指向一個足夠大的緩沖區,用于保存描述符
	PULONG			ioLength );  // 指向長度單元,輸入時為準備讀取的長度,返回后為實際讀取的長度


BOOL	WINAPI	CH375SetIntRoutine(  // 設定中斷服務程序
	ULONG			iIndex,  // 指定CH375設備序號
	mPCH375_INT_ROUTINE	iIntRoutine );  // 指定中斷服務回調程序,為NULL則取消中斷服務,否則在中斷時調用該程序


BOOL	WINAPI	CH375ReadInter(  // 讀取中斷數據
	ULONG			iIndex,  // 指定CH375設備序號
	PVOID			oBuffer,  // 指向一個足夠大的緩沖區,用于保存讀取的中斷數據
	PULONG			ioLength );  // 指向長度單元,輸入時為準備讀取的長度,返回后為實際讀取的長度


BOOL	WINAPI	CH375AbortInter(  // 放棄中斷數據讀操作
	ULONG			iIndex );  // 指定CH375設備序號


BOOL	WINAPI	CH375ReadData(  // 讀取數據塊
	ULONG			iIndex,  // 指定CH375設備序號
	PVOID			oBuffer,  // 指向一個足夠大的緩沖區,用于保存讀取的數據
	PULONG			ioLength );  // 指向長度單元,輸入時為準備讀取的長度,返回后為實際讀取的長度


BOOL	WINAPI	CH375AbortRead(  // 放棄數據塊讀操作
	ULONG			iIndex );  // 指定CH375設備序號


BOOL	WINAPI	CH375WriteData(  // 寫出數據塊
	ULONG			iIndex,  // 指定CH375設備序號
	PVOID			iBuffer,  // 指向一個緩沖區,放置準備寫出的數據
	PULONG			ioLength );  // 指向長度單元,輸入時為準備寫出的長度,返回后為實際寫出的長度


BOOL	WINAPI	CH375AbortWrite(  // 放棄數據塊寫操作
	ULONG			iIndex );  // 指定CH375設備序號


BOOL	WINAPI	CH375WriteRead(  // 先寫出標準的數據塊(命令),再讀取標準的數據塊(應答)
	ULONG			iIndex,  // 指定CH375設備序號
	PVOID			iBuffer,  // 指向一個緩沖區,放置準備寫出的數據,長度不大于mCH375_PACKET_LENGTH
	PVOID			oBuffer,  // 指向一個足夠大的緩沖區,長度不小于mCH375_PACKET_LENGTH,用于保存讀取的數據
	PULONG			ioLength );  // 指向長度單元,不大于mCH375_PACKET_LENGTH,輸入時為準備寫出的長度,返回后為實際讀取的長度


BOOL	WINAPI	CH375GetStatus(  // 通過CH375直接輸入數據和狀態
	ULONG			iIndex,  // 指定CH375設備序號
	PULONG			iStatus );  // 指向一個雙字單元,用于保存狀態數據
// 位7-位0對應CH375的D7-D0引腳,位9對應CH375的RXD#引腳,位10對應CH375的REQ#引腳


BOOL	WINAPI	CH375SetTimeout(  // 設置USB數據讀寫的超時
	ULONG			iIndex,  // 指定CH375設備序號
	ULONG			iWriteTimeout,  // 指定USB寫出數據塊的超時時間,以毫秒mS為單位,0xFFFFFFFF指定不超時(默認值)
	ULONG			iReadTimeout );  // 指定USB讀取數據塊的超時時間,以毫秒mS為單位,0xFFFFFFFF指定不超時(默認值)


BOOL	WINAPI	CH375WriteAuxData(  // 寫出輔助數據
	ULONG			iIndex,  // 指定CH375設備序號
	PVOID			iBuffer,  // 指向一個緩沖區,放置準備寫出的數據
	PULONG			ioLength );  // 指向長度單元,輸入時為準備寫出的長度,返回后為實際寫出的長度


BOOL	WINAPI	CH375SetExclusive(  // 設置獨占使用當前CH375設備
	ULONG			iIndex,  // 指定CH375設備序號
	ULONG			iExclusive );  // 為0則設備可以共享使用,非0則獨占使用


ULONG	WINAPI	CH375GetUsbID(  // 獲取USB設備ID,返回數據中,低16位為廠商ID,高16位為產品ID,錯誤時返回全0(無效ID)
	ULONG			iIndex );  // 指定CH375設備序號


PVOID	WINAPI	CH375GetDeviceName(  // 返回指向CH375設備名稱的緩沖區,出錯則返回NULL
	ULONG			iIndex );  // 指定CH375設備序號,0對應第一個設備


BOOL	WINAPI	CH375SetBufUpload(  // 設定內部緩沖上傳模式
	ULONG			iIndex,  // 指定CH375設備序號,0對應第一個設備
	ULONG			iEnableOrClear );  // 為0則禁止內部緩沖上傳模式,使用直接上傳,非0則啟用內部緩沖上傳模式并清除緩沖區中的已有數據
// 如果啟用內部緩沖上傳模式,那么CH375驅動程序創建線程自動接收USB上傳數據到內部緩沖區,同時清除緩沖區中的已有數據,當應用程序調用CH375ReadData后將立即返回緩沖區中的已有數據


LONG	WINAPI	CH375QueryBufUpload(  // 查詢內部上傳緩沖區中的已有數據包個數,成功返回數據包個數,出錯返回-1
	ULONG			iIndex );  // 指定CH375設備序號,0對應第一個設備


BOOL	WINAPI	CH375SetBufDownload(  // 設定內部緩沖下傳模式
	ULONG			iIndex,  // 指定CH375設備序號,0對應第一個設備
	ULONG			iEnableOrClear );  // 為0則禁止內部緩沖下傳模式,使用直接下傳,非0則啟用內部緩沖下傳模式并清除緩沖區中的已有數據
// 如果啟用內部緩沖下傳模式,那么當應用程序調用CH375WriteData后將僅僅是將USB下傳數據放到內部緩沖區并立即返回,而由CH375驅動程序創建的線程自動發送直到完畢


LONG	WINAPI	CH375QueryBufDownload(  // 查詢內部下傳緩沖區中的剩余數據包個數(尚未發送),成功返回數據包個數,出錯返回-1
	ULONG			iIndex );  // 指定CH375設備序號,0對應第一個設備


BOOL	WINAPI	CH375ResetInter(  // 復位中斷數據讀操作
	ULONG			iIndex );  // 指定CH375設備序號


BOOL	WINAPI	CH375ResetAux(  // 復位輔助數據寫操作
	ULONG			iIndex );  // 指定CH375設備序號


BOOL	WINAPI	CH375ResetRead(  // 復位數據塊讀操作
	ULONG			iIndex );  // 指定CH375設備序號


BOOL	WINAPI	CH375ResetWrite(  // 復位數據塊寫操作
	ULONG			iIndex );  // 指定CH375設備序號


typedef		VOID	( CALLBACK	* mPCH375_NOTIFY_ROUTINE ) (  // 設備事件通知回調程序
	ULONG			iEventStatus );  // 設備事件和當前狀態(在下行定義): 0=設備拔出事件, 3=設備插入事件

#define		CH375_DEVICE_ARRIVAL		3		// 設備插入事件,已經插入
#define		CH375_DEVICE_REMOVE_PEND	1		// 設備將要拔出
#define		CH375_DEVICE_REMOVE			0		// 設備拔出事件,已經拔出


BOOL	WINAPI	CH375SetDeviceNotify(  // 設定設備事件通知程序
	ULONG					iIndex,  // 指定CH375設備序號,0對應第一個設備
	PCHAR					iDeviceID,  // 可選參數,指向字符串,指定被監控的設備的ID,字符串以\0終止
	mPCH375_NOTIFY_ROUTINE	iNotifyRoutine );  // 指定設備事件回調程序,為NULL則取消事件通知,否則在檢測到事件時調用該程序


BOOL	WINAPI	CH375SetTimeoutEx(  // 設置USB數據讀寫的超時
	ULONG			iIndex,  // 指定CH375設備序號
	ULONG			iWriteTimeout,  // 指定USB寫出數據塊的超時時間,以毫秒mS為單位,0xFFFFFFFF指定不超時(默認值)
	ULONG			iReadTimeout,  // 指定USB讀取數據塊的超時時間,以毫秒mS為單位,0xFFFFFFFF指定不超時(默認值)
	ULONG			iAuxTimeout,  // 指定USB輔助下傳數據的超時時間,以毫秒mS為單位,0xFFFFFFFF指定不超時(默認值)
	ULONG			iInterTimeout );  // 指定USB中斷上傳數據的超時時間,以毫秒mS為單位,0xFFFFFFFF指定不超時(默認值)


#ifdef __cplusplus
}
#endif

#endif		// _CH375_DLL_H