?？低暡シ艓靤dk編程指南for

SDK版本更 3.1庫錯誤碼說 獲取庫SDK版本號和build號 初始化Direct表面 釋放Direct表 打開文件 設(shè)置流模式 獲取流模式 開 關(guān) 快 慢 單幀前進 單幀回退 關(guān)閉聲音（獨占方式） 關(guān)閉聲音（共享方式） 設(shè)置音 獲取音 調(diào)整WAVE波 設(shè)置圖像質(zhì) 獲取圖像質(zhì)量 設(shè)置參 獲取參 設(shè)置圖像銳化 設(shè)置圖像Overlay翻轉(zhuǎn)模 設(shè)置圖像旋轉(zhuǎn)模式 獲取文件當前位置（百分比） 獲取文件當前時間（毫秒） 獲取或信 獲取當前幀率 獲取原始圖像大小 獲取當前顯示幀的全局時間 設(shè)置幀類型 回調(diào) 音頻回調(diào) 文件結(jié)束消息 文件結(jié)束回調(diào) 分辨改變通知消息 設(shè)置丟B幀個數(shù) 檢查幀號是否連 密 設(shè)置OVERLAY顯示模式及關(guān)鍵 獲取當前是否采用OVERLAY顯示模 獲取OVERLAY關(guān)鍵 刷新顯 設(shè)置顯示模 獲取顯示模 獲取源緩沖區(qū)剩余數(shù)據(jù)大小 后緩沖 源、緩沖 清空所有緩沖區(qū)的剩余數(shù)據(jù) 清空指定緩沖區(qū)的剩余數(shù)據(jù) 獲取指定緩沖區(qū)的大小 設(shè)置建立索引回調(diào) 查找指定位置之前的關(guān)鍵幀位置 查找指定位置之后的關(guān)鍵幀位置 獲取文件索引 設(shè)置文件索引 枚舉系統(tǒng)中的顯示設(shè)備 獲取顯示設(shè)備（顯卡）個數(shù) 獲取指定顯卡和監(jiān)視器信息 圖像數(shù)據(jù)轉(zhuǎn)為BMP格 圖像數(shù)據(jù)轉(zhuǎn)為JPEG格式 直接抓取BMP圖像 直接抓取JPEG圖像 設(shè)置JPEG圖像質(zhì) 抓取選擇區(qū)域為JPEG格 抓取選擇區(qū)域為BMP格 畫圖回 設(shè)置數(shù)據(jù)校 1服務(wù)器、IP設(shè)備的配套產(chǎn)品的相關(guān)的二次開發(fā)包，適用于以下編碼產(chǎn)品數(shù)據(jù)流與系列、系列（ATM、車載、環(huán)境監(jiān)測、審訊）網(wǎng)絡(luò)硬盤機DS-95xx/96xx系列、DS-76xx系列SDKSDK版本號自V6.3.0.0V主版本號.子版本號.修正版本號.修正版本號升級：局部修改，bug yM4_SetSycStartTime, 0123多456789流器的顯示部分，主要采用了DirectDraw技術(shù)。目前使用了兩種方式顯示畫面：第式使用Off_screen畫面，優(yōu)點：多路可以相對對立，相互間不受影響，缺O(jiān)VERLAY畫面支持硬件的縮放，當?shù)谑降貌坏斤@卡支持時，使用OVERLAY畫面OVERLAY畫面處于活動狀態(tài)，因此同時只能有一路器使用OVERLAY畫面，而且如果其他程序正在使用OVERLAY畫面，那么器就不能再使用OVERLAY畫面了，同樣，如果器使用了OVERLAY畫面，其他程序也不能再使用OVERLAY畫面。而我們在顯示這一塊的處理，大部分還是需要依靠顯卡的BLT功能（硬件縮放，，那么相對的，cpu的利用率就會有所升高。 y) y) 函數(shù)： 參數(shù)：16build 獲取錯誤 函數(shù)： 參數(shù)：LONGnPort 返回值：錯誤碼，詳見錯誤碼宏定 測試所需系統(tǒng)功 函數(shù)： 參

支持DIRECTDRAW；如果不支持，則器不能工作

顯卡BLTX顯卡BLTYCPU支持SSE指令,InPentium3以上支持SSE指令說明：測試器需要的一些系統(tǒng)功注意：CPU放大縮小，建議將顯示窗口的大小設(shè)置和圖像的大小一致，例如后的圖像是352*288（PAL）大小，則建議顯示窗口也設(shè)置為352*288。初始化Direct表 函數(shù)： 參數(shù)：HWND 返回值：成功返回TURE；失敗返回FALSE 意：1.1版本以上SDK不需要調(diào)釋放Direct表 函數(shù)： 參注意：1.1SDK設(shè)置使用的定時器類 函數(shù)： 參數(shù)： n

#defineTIMER_1#defineTIMER_2低，不推薦在高倍速時使用。TURE 意：必須 獲取使用的定時器類 函數(shù)： *p參數(shù)： DWORD p

獲取未使用的通道 函數(shù)： 參數(shù)：[out]LONG*nPort 返回值：成功返回TURE；失敗返回FALSE 明：獲取未使用的通道號,通道號的上限為500釋放已使用的通道 函數(shù)：BOOL 參數(shù)：LONG 返回值：成功返回TURE；失敗返回FALSE 明：釋放已使用的通道號，釋放成功后，最好將nPort置為-1打開文 函數(shù)： 參數(shù)：

意：文件過4GB或小于4KB關(guān)閉文 函數(shù)： 參數(shù)：LONG 設(shè)置流模 函數(shù)： 參數(shù)：

#defineSTREAME_REALTIME0#define STREAME_REALTIME模式（默認） TURE 意：必須在之前設(shè)置。2.2以上版本SDK以后可以做暫停，快放，慢放，單幀播 獲取流模 函數(shù) 參數(shù) 返回值：STREAME_REALTIME打開 函數(shù)：BOOL DWORDnBufPoolSize)參數(shù)：

會導致無法，建議標清設(shè)備該值大于等于200*1024，設(shè)備大于等于600*1024。TURE關(guān)閉 函數(shù)： 參數(shù)：LONGnPort 返回值：成功返回TURE；失敗返回FALSE輸入流數(shù) 函數(shù)： 參數(shù)：

返回值：TURE表示已經(jīng)輸入數(shù)據(jù)。FALSE 明：輸入流數(shù)據(jù)，需要在開啟流之后才能輸入數(shù)據(jù)，返回False一般是由于內(nèi)部緩沖能跳幀或者花屏，如果無法接受，則sleep幾毫秒后，再嘗試多送幾次 函數(shù)：BOOL DWORDnBufPoolSize)參數(shù)：

設(shè)置器中存放數(shù)據(jù)流的緩沖區(qū)大小。范圍TURE 明：以音分開輸入的方式打開流 函數(shù)： 參數(shù)：LONG 返回值：成功返回TURE；失敗返回FALSE 函數(shù)：BOOL yM4_OpenStreamAdvanced(LONGnPort,intnProtocolType,YM4_SESSION_INFO*pstSessionInfo,DWORDnBufPoolSize)參數(shù)： #define {

RTSP unsignedchar*}返回值：成功返回TURE

明：該接口是使用非?？?0個字節(jié)開流，現(xiàn)支持用SDP開輸入 函數(shù)： 參數(shù)：

TURE,表示已經(jīng)輸入數(shù)據(jù)。FALSE 明：輸入流(可以是復合流，但音頻數(shù)據(jù)會被忽略)；打開流之后才能輸入數(shù)據(jù)能跳幀或者花屏，如果無法接受，則sleep幾毫秒后，再嘗試多送幾次輸入音頻 函參 通道 返回值：TURE,表示已經(jīng)輸入數(shù)據(jù)。FALSE 明：輸入音頻流；打開聲音之后才能輸入數(shù)據(jù)。返回False是由于內(nèi)部緩沖區(qū)滿，建能跳幀或者聲音不連續(xù)，如果無法接受，則sleep幾毫秒后，再嘗試多送幾次開 函數(shù)： 參數(shù)：

TURE 明：開始，畫面大小將根據(jù)hWnd窗口調(diào)整，要全屏顯示，只要把關(guān) 函數(shù)： 參數(shù)： 暫停/恢 函數(shù)： 參數(shù)：

明：在非狀態(tài)下，無法使用暫停。在調(diào)用暫停情況下，才能啟用恢復?；謴秃罂?函數(shù)：BOOL 參數(shù)：LONG 明：每次調(diào)用將使當前速度加快一倍，最多調(diào)用4次；要恢復正常調(diào)慢 函數(shù)： 參數(shù)：LONG 明：每次調(diào)用將使當前速度慢一倍；最多調(diào)用4次；要恢復正常調(diào)單幀前 函數(shù)： 參數(shù)：LONG 明：恢復正常需要調(diào) 單幀回 函數(shù)： 參數(shù)：LONG 明：每調(diào)用一次一幀。 意：只支持文件，必須在文件索引生成之后才能調(diào)以獨占方式打開聲 函數(shù)： 參數(shù)： 明：同一時刻只能有一路聲音。如果現(xiàn)在已經(jīng)有聲音打開，則自動關(guān)閉原來已經(jīng)打 意：默認情況下聲音是關(guān)閉的yM4_ySound，yM4_StopSound需要配對調(diào)用 yM4_ySound，yM4_ySoundShare不要混用 函數(shù)： 參數(shù)：無TURE 意 yM4_ySound，yM4_StopSound需要配對調(diào)用以共享方式打開聲 函數(shù)： 參數(shù)：LONG TURE 明：以共享方式聲音，本路聲音而不去關(guān)閉其他路 意：WIN98及其之前版本操作系統(tǒng)不支持創(chuàng)建多個聲音設(shè)備。如果聲卡已經(jīng)被使用yM4_ySoundShare，yM4_StopSoundShare需要配對調(diào)用 yM4_ySound，yM4_ySoundShare不要混用 函數(shù)： 參數(shù)：LONG 明：以共享方式關(guān)閉聲音 ym4_ySound和 yM4_StopSound是以獨占方式 意：在同一個進程中，所有通道必須使用相同的方式或關(guān)閉聲音yM4_ySoundShare，yM4_StopSoundShare需要配對調(diào)用設(shè)置音 函數(shù)： 參數(shù)：

返回值：成功返回TURE 的初始音量。這里的音量是只聲卡輸出的主音量，會影響到其他應(yīng)用。獲取音 函數(shù)： 參數(shù)： 返回值：音量值。這里的音量是只聲卡輸出的主音量，會影響到其他應(yīng)用調(diào)整WAVE波 函數(shù)： 參數(shù)：LONGLONG

MIN_WAVE_COEF返回值：成功返回TURE 調(diào)整WAVE波形，可以改音的大小 設(shè)置圖像質(zhì) 函數(shù)： 參數(shù)：

0為高質(zhì)量，01TURE 明：當設(shè)置成高質(zhì)量時畫面效果好，但CPU利用率高獲取圖像質(zhì) 函數(shù)： 參數(shù)：

1表示高質(zhì)量，0設(shè)置參 函數(shù)：BOOL intnContrast,intnSaturation,intnHue)參數(shù)：

顯示區(qū)域，參考yM4_SetDisyRegion；如果只有一個顯示區(qū)域(通常情況)設(shè)為0亮度，默認色調(diào)，默認TURE 意：如果全部為默認值將不進行顏色調(diào)獲取參 函數(shù)：BOOL int*pContrast,int*pSaturation,int*pHue)參數(shù)： [out]int* [out]int* [out]int* [out]int*

640-128色調(diào)，默認640-128返回值：成功返回TURE設(shè)置圖像銳 函數(shù)： 參數(shù)：

銳化級別（1～6，0不做銳化，1低級，6高級）TURE 設(shè)置圖像Overlay翻轉(zhuǎn)模 函數(shù)： yM4_SetOverlayFlipMode(LONGnPort,BOOL參數(shù)：

TURE 明：早期的版本指overlay表面前緩沖區(qū)緊跟著一個或多個建立好的后緩沖區(qū)提高顯示效率，6.1.0.3以上版本后沒有功用。設(shè)置圖像旋轉(zhuǎn)模 函數(shù)： 參數(shù)： #define #define #define #define TURE

函數(shù)： 參數(shù)：

明：設(shè)置文件指針的相對位置（百分比 yM4_y之后調(diào)用才有效 函數(shù)：float yM4_GetyPos(LONGnPort)參數(shù)：LONGnPort 返回值：范圍0-100% 明：獲得文件指針的相對位置 函數(shù)： 參數(shù)：

TURE 明：根據(jù)時間設(shè)置文件位 意：如果在建立文件索引的前提下使用,為精確定位,否則即為粗略定 yM4_y之后調(diào)用才有 函數(shù)： 參數(shù)：LONG 返回值：文件當前的時間，單位毫秒 設(shè)置文件當前幀 函數(shù)： 參數(shù)： nFra

明：設(shè)置當前位置到指定幀號；根據(jù)幀號來定位位置 意：如果在建立文件索引的前提下使用,為精確定位,否則即為粗略定 yM4_y之后調(diào)用才有效獲取文件當前幀 函數(shù)： m(LONG參數(shù)：LONG 返回值：當前的幀序號 明：得到當前的幀序號有 去閃 函數(shù)： 參數(shù)：

TURE說明：設(shè)置是否去閃爍功能,原先在靜止圖像區(qū)域有噪聲情況下,圖像會產(chǎn)生閃爍現(xiàn)獲取或信獲取文件總時 函數(shù)： 參數(shù)：LONG 返回值：文件總時間長度，單位秒 意：不支持對正在寫入的文件進行時間的獲取文件總幀 函數(shù)： 參數(shù)：LONG 返回值：文件總幀數(shù) 意：不支持對正在寫入的文件進行幀數(shù)的獲取當前幀 函數(shù)： 參數(shù)：LONG 返回值：當前碼流中當前編碼幀率 獲取已時 函數(shù)： 參數(shù)：LONG 返回值：文件當前時間，單位秒獲取已的幀 函數(shù)： 參數(shù)：LONG 返回值：已經(jīng)的幀數(shù)獲取原始圖像大 函數(shù)： 參數(shù)： [out]LONG*

TURE 意：該函數(shù)獲取的是剛剛那幀數(shù)據(jù)的長寬，因此只有當開始后才能獲取準確 獲取文件頭長 函數(shù)： 參 明：得到當前版本器能的文件的文件頭長度。主要應(yīng)用在流器的STREAME_FILE模式下。以便讀出文件頭作為 例程(以通道為0的通道為例)： voidStart(){DWORDnLength PBYTEpFileHead newBYTE[nLength];{} yM4_y(0,m_hWnd);delete[]pFileHead;}voidInputData(){BYTE { }}獲取當前顯示幀的全局時 函數(shù)： yM4_GetSpecialData(LONG參數(shù)： #defineGET_YEAR(_time_) (((_time_)>>26)+2000)#defineGET_MONTH(_time_) (((_time_)>>22)&15)#defineGET_DAY(_time_) (((_time_)>>17)&31)#defineGET_HOUR(_time_) (((_time_)>>12)&31)#defineGET_MINUTE(_time_) &63)#defineGET_SECOND(_time_) &63) 明：有正常圖像顯示后才能調(diào)用此接設(shè)置回調(diào)流類 函數(shù)： 參數(shù)：

1流，2音頻流，3復合 明：建議在回調(diào)函數(shù)前使設(shè)置幀類 函數(shù)： 參數(shù)：

#define 0#define 1#defineDECODE_NONE 2不解幀返回值：成功返回TURE；失敗返回FALSE 回調(diào) BOOLyM4_SetDecCallBack(LONGnPort,void(CALLBACK*DecCBFun)(longnPort,char*pBuf,longnSize,FRAME_INFO*pFrameInfo,longn1,longn2))參數(shù)： char FRAME_INFO*pFrameInfo ntypedef DWORDdwFra

置為NULL，否則不能為NULL16位表示。 說明：設(shè)置回調(diào)函數(shù)，替換器中的顯示部分，由用戶自己控制顯示，該函數(shù)在yM4_y之前調(diào)用，在yM4_Stop時自動失效，下次調(diào)用yM4_y之前注意：部分不控制速度，只要用戶從回調(diào)函數(shù)中返回，器就會下一部分據(jù)。這個功能的使用需要用戶對顯示和聲音有足夠的了解，否則請慎重使用，有關(guān)知識請參閱directx開發(fā)包。 函 (longnPort,char*pBuf,longnSize,FRAME_INFO*pFrameInfo,longnUser,參n2),long char ntypedef

為NULL，否則不能為返回值：成功返回TURE說明：設(shè)置回調(diào)函數(shù)，替換器中的顯示部分，由用戶自己控制顯示，該函數(shù)在yM4_y之前調(diào)用，在yM4_Stop時自動失效，下次調(diào)用yM4_y之前了解，否則請慎重使用，有關(guān)知識請參閱directx開發(fā)包。回調(diào)函數(shù)yM4_SetDecCallBack區(qū)別在于增加了用戶傳遞參數(shù)當前的數(shù)據(jù)格式為YV12，音頻格式為PCM。 函數(shù)：BOOLyM4_SetDecCallBackEx(LONGnPort,void(CALLBACK*DecCBFun)(longnPort,char*pBuf,longnSize,FRAME_INFO*pFrameInfo,longn1,longn2),char*pDest,longnDestSize)參數(shù)： DecCBFun回調(diào)函數(shù)參數(shù)說 char typedefstruct{longLongnHeightlongnStamplongnTypelong n n

回調(diào)函數(shù)，若不需要回調(diào)函數(shù)則置為，TURE 明 yM4_SetDecCallBackEx yM4_SetDecCallBack相比yM4_SetDecCallBackEx會并顯示，并將的數(shù)據(jù)以回調(diào)函數(shù)的方式給用 yM4_SetDecCallBack僅僅將后的數(shù)據(jù)給用戶，并不顯示。其中參數(shù)pDestnDestSize沒有具體的用處,NULL當前的數(shù)據(jù)格式為YV12，音頻格式為PCM函數(shù)：BOOL yM4_SetDecCallBackExMend(LONGnPort,void(CALLBACK*DecCBFun)(longnPort,char*pBuf,longnSize,FRAME_INFO*pFrameInfo,longnUser,longn2),char*pDest,longnDestSize,long參數(shù)： DecCBFun回調(diào)函數(shù)參數(shù)說 char typedefstruct{ n

則不能為NULL，TURE 明 yM4_SetDecCallBackExMend yM4_SetDecCallBackMend相比yM4_SetDecCallBackExMend會并顯示并將的數(shù)據(jù)以回調(diào)函數(shù)的方式 yM4_SetDecCallBackMend僅僅將后的數(shù)據(jù)給用戶，并不顯當前的數(shù)據(jù)格式為YV12，音頻格式為PCM音頻回 函數(shù)：BOOL yM4_SetAudioCallBack(LONGnPort,void(stdcall*funAudio)(longnPort,char*pAudioBuf,longnSize,longnStamp,longnType,longnUser),longnUser)參數(shù)： void(stdcall*funAudio)

T_AUDIO16,16khz，單聲道，每個采樣點16位TURE 意：暫不支文件結(jié)束消 函數(shù)： 參數(shù)：

用戶自定義的輸入的消息；當?shù)轿募Y(jié)束時用戶從hWnd窗口過程中收到這個消息。此消息函數(shù)中的ram參數(shù)返回nPort的值TURE說明：設(shè)置文件結(jié)束時要發(fā)送的消息；從2.4版本SDK起，當文件完時，線程將不會自動結(jié)束，需要用戶做停止工作。應(yīng)用程序在收到這個消息后要調(diào)用結(jié)束函數(shù)yM4_Stop(nPort)注意：文件結(jié)束回 函數(shù)： 參數(shù)： void* void*TURE

明：設(shè)置文件結(jié)束回調(diào)函數(shù)在 y4_OpenFile之前調(diào)用才 意：關(guān)于回調(diào)函數(shù)。因為vb不支持多線程，所以當回調(diào)函數(shù)是VB的函數(shù)時vcvb詳見：KnowledgeBaseArticle-Q198607“PRB:AccessViolationinVBRun-TimeUsingAddressOf、分辨改變通知消 函數(shù)： 參數(shù)：

此定義的消息。消息函數(shù)中的ram參數(shù)值是返回nPortTURE 明：設(shè)置時編碼分辨率發(fā)生改變時要發(fā)送的消息 意：回調(diào)與消息不能同時使用分辨率改變通知回 函數(shù)： 參數(shù)： longnPortlong

明：需要在打開文件之前使 意：不推薦回調(diào)與消息方式同時使設(shè)置丟B幀個 函數(shù)： 參數(shù)：

明：設(shè)置 若編碼類型中無B幀，則調(diào)用此接口無效。檢查幀號是否連 函數(shù)： m(LONGnPort,BOOL參數(shù)： 一個I幀；FALSE：查幀號連續(xù)性。如果數(shù)據(jù)能，則，不直接跳至下一個I幀。TURE 6.1.1.17版本開始支持。密鑰 函數(shù)：BOOL 參數(shù)： char*

密鑰長度，單位為bit（18TURE 碼。該接口在 設(shè)置OVERLAY顯示模式及關(guān)鍵 函數(shù)： 參數(shù)：

其他模式。FALSE則不進行OVERLAY模式的嘗試。用一種不常用的顏色作為透明色。這是一個雙字節(jié)值TURE說明：設(shè)置OVERLAYOVERLAY于活動狀態(tài)，如果此時系統(tǒng)中已經(jīng)有程序使用了OVERLAY，那么器就不能再們的卡在預覽時可能也要使用OVERLAY(用戶可設(shè)置)，如果先打開器（并且OVERLAYOVERLAY而失敗。OVERLAYOVERLAYBLT缺點是：只能有一路器使用。該設(shè)置必須在Y之前使用，而且需要設(shè)置獲取當前是否采用OVERLAY顯示模 函數(shù)： yM4_GetOverlayMode(LONG參數(shù)： 說明：檢查當前器是否使用了OVERLAY模獲取OVERLAY關(guān)鍵 函數(shù)： 參數(shù)：LONGnPort 返回值：顏色值設(shè)置或增加顯示區(qū) 函數(shù)：BOOL yM4_SetDisyRegion(LONGnPort,DWORDnRegionNum,RECT*pSrcRect,HWNDhDestWnd,BOOLbEnable)參數(shù)： RECT

顯示區(qū)域序號，0~(MAX_DISY_WND-1)(yM4_y中設(shè)置的窗口)進行設(shè)置，將忽略hDestWnd和bEnable的設(shè)置。0，352，288）pSrcRect=NULL,將顯示整個TURE 明：設(shè)置或增加顯示區(qū)域。可以做局部放大顯示刷新顯 函數(shù)：BOOL 參數(shù)：LONG 返回值：成功返回TURE；失敗返回FALSE 函參 返回值：成功返回TURE；失敗返回FALSE 明：刷新顯示，同 yM4_Refreshy。為支持 y4_SetDisyRegion而增加一個設(shè)置顯示模 函數(shù)： 參數(shù)：

DISY_NORMAL正常分辨率數(shù)據(jù)送顯卡顯示。DISY_QUARTER1/4分辨率數(shù)據(jù)送顯卡顯示。DISY_YC_SCALEYC伸張DISY_NOTEARING無顯示效TUREDISY_QUARTER可以減小顯卡工作量，從而支持路顯示，但畫面顯示質(zhì)量有下降。在正常和大畫面顯示時應(yīng)該使用DISY_NORMAL。參數(shù)nType12獲取顯示模 函數(shù)： 參數(shù)： 返回值： Y_NORMAL或 說明：nType獲取源緩沖區(qū)剩余數(shù)據(jù)大 函數(shù)： 參數(shù)： 設(shè)置源緩沖區(qū)閾值及回調(diào)指 函數(shù)：BOOL yM4_SetSourceBufCallBack(LONGnPort,DWORDnThreShold,dwUser,void*pResvered),DWORDdwUser,void*p)參數(shù)：LONG void p nBufSize dwUser TURE

明：設(shè)置源緩沖區(qū)閥值和剩余數(shù)據(jù)小于等于閥值時的回調(diào)函數(shù)指針。只有在數(shù)據(jù)量從大到小"越過"指定閾值的時候,才會觸發(fā)回調(diào); 重置回調(diào)標志為有效狀 函數(shù)： 參數(shù)：LONG 明：重置回調(diào)標志位為有效狀態(tài)。后緩沖設(shè)置緩沖區(qū)最大緩沖幀 函數(shù)： 參數(shù)：

352*288圖像的所需內(nèi)存最小值是352*288*3/2返回值：成功返回TURE；失敗返回FALSE 明： 設(shè)置緩沖區(qū)（即后的圖像緩沖區(qū)）大??；這個緩沖區(qū)比較重要，直接影響的流暢性和延時性。在一定范圍內(nèi)緩沖越大越流暢，同時延時越大15（幀），在25幀/秒的情況下即0.6秒的數(shù)據(jù)。在流時我們的默認值 yM4_OpenStream之后、yM4_y之前調(diào)用有獲取緩沖區(qū)最大緩沖幀 函數(shù)： 參數(shù)：LONG 返回值：緩沖區(qū)最大緩沖幀數(shù)源、緩沖清空所有緩沖區(qū)的剩余數(shù) 函數(shù)： 參數(shù)：LONG 返回值：成功返回TURE；失敗返回FALSE清空指定緩沖區(qū)的剩余數(shù) 函數(shù)： 參數(shù)：

有效，單位byte。獲取指定緩沖區(qū)的大小函數(shù)： 參數(shù)：

有效，單位byte。后節(jié)點數(shù)（上限BUF__RENDER） byte設(shè)置建立索引回調(diào)函 yM4_SetFileRefCallBack(LONGnPort,void(stdcall參 void(stdcall*pFileRefDone) 立索引的過程是在完成，需要使用索引的函數(shù)要等待這個過程結(jié)束，而其他打開文件時是否建立文件的關(guān)鍵幀索引,如果索引回調(diào)未觸發(fā),表明文件查找指定位置之前的關(guān)鍵幀位置函數(shù)：BOOL PFRAME_POSpFramePos)參PFRAME_POS類型說明typedef

TURE說明：查找指定位置之前的關(guān)鍵幀位置。圖像必須從關(guān)鍵幀開始，如果用戶保存的3幀數(shù)據(jù)。查找指定位置之后的關(guān)鍵幀位置函數(shù)：BOOL PFRAME_POSpFramePos)參數(shù)：

如果nType是BY_FRAM則nValue表示幀號，PFRAME_POStypedef

TURE 明：查找指定位置之后的關(guān)鍵幀位置獲取文件索 函數(shù)： 參數(shù)： DWORD*

TURE 明：獲取文件索引信息，以便下次打開同一個文件時直接使用這個信息。必須在索引設(shè)置文件索 函數(shù)： 參數(shù)：

TURE 意：索引信息及其長度必須準確，在OpenFile之后調(diào)用sdk相關(guān)文檔“Multiple-MonitorSystems“。枚舉系統(tǒng)中的顯示設(shè) 函數(shù)： 參 意：V6.1.1.0版本及以后版本可以不用顯式調(diào)用該函數(shù)函數(shù)： 參數(shù)：無 意：V6.1.1.0版本及以后版本可以不用顯式調(diào)用該函數(shù) 函數(shù)： 參TURE說明：獲得系統(tǒng)中與windows桌面綁定的總的顯示設(shè)備數(shù)目（這里主要是指顯卡注意：V6.1.1.0設(shè)置窗口使用的顯示設(shè) 函參 函數(shù)：BOOL DWORDnDeviceNum)參數(shù)：

返回值：成功返回TURE 為支持yM4_SetDisyRegion而增加一個參數(shù)。 獲取指定顯卡和監(jiān)視器信息函數(shù)： DWORDnNameLen,HMONITOR*hhMonitor)參數(shù)：DWORD [out]HMONITOR*hhMonitor

lpDriverDescription已分配空間的大小，單位顯示設(shè)備使用的監(jiān)視器句柄，通過WindowsAPITURE注意：HMONITOR_WIN32_WINNT>=0x0500時，在“windef.h”頭文件中定義，V6.1.1.06.2.0.x版本后不再起作獲取指定顯示設(shè)備的系統(tǒng)信 函數(shù)： (DWORD參數(shù)：

意：V6.1.1.0版本及以后版本多屏顯示可以自適應(yīng)該接口在6.2.0.x版本后不再起抓圖回 函數(shù)：BOOL (longnPort,char*pBuf,longnSize,longnWidth,longnHeight,longnStamp,參數(shù)： (CALLBACK*Dis char*pBuf TURE

為NULL，否則不能置為NULL yM4_SetDecCallBack宏定義說明：設(shè)置抓圖回調(diào)函數(shù)；注意要盡快返回，如果要停止回調(diào)，可以把回調(diào)函數(shù)指針回調(diào)在時鐘線程中觸發(fā)不能出現(xiàn)耗時操作否則會打亂時鐘脈沖 函數(shù)：BOOL yM4_SetDisyCallBackEx(LONGnPort,void(CALLBACK*DisyCBFun)(DISY_INFO*pstDisyInfo),longnUser)參數(shù)： DisyCBFun回調(diào)函數(shù)參數(shù)說DISY_INFO*pstDis Y_INFOtypedef{

char*pBuf; }DISTURE

yM4_SetDecCallBack宏定義 明：當前獲取到的圖像數(shù)據(jù)類型為YV12格圖像數(shù)據(jù)轉(zhuǎn)為BMP格 函數(shù)：BOOL nHeight,longnType,char*sFileName)參數(shù)：char* char*

TURE 明：將后數(shù)據(jù)保存成BMP文件。送入的圖像數(shù)據(jù)必須是YV12數(shù)據(jù)，可從圖像數(shù)據(jù)轉(zhuǎn)為JPEG格 函數(shù)：BOOL yM4_ConvertToJpegFile(char*pBuf,longnSize,longnWidth,longnHeight,longnType,char*sFileName)參數(shù)：char* char*TURE

（當前的庫獲取的類型是 明：將后數(shù)據(jù)保存成JPEG文件,該函數(shù)可在回調(diào)函數(shù)中使用, 直接抓取BMP圖 函數(shù)：BOOL DWORD*pBmpSize)參數(shù)：

w*h*4，其中wh分別為圖像寬高。TURE說明：獲取的數(shù)據(jù)為一幀bmp數(shù)據(jù)，寫成文件即可用瀏覽工具查直接抓取JPEG圖 函數(shù)：BOOL DWORD*pJpegSize)參數(shù)：

JEPGJPEG圖返回值：成功返回TURE說明：獲取的數(shù)據(jù)為一幀JPEG數(shù)據(jù)，寫成文件即可用瀏覽工具查設(shè)置JPEG圖像質(zhì) 函數(shù)： 參數(shù)： 圖像質(zhì)量,但抓取的圖像大小最100:圖像質(zhì)量最好,但抓取的圖像大小最大返回值：成功返回TURE；失敗返回FALSE 明：設(shè)置抓取的JPEG圖像質(zhì)量,設(shè)置范圍0~100,建議使用75~90,若不調(diào)用該函數(shù),則采用默認圖像質(zhì)量,目前默認為80。需要在抓圖進行前調(diào)用，建議在抓取選擇區(qū)域為JPEG格式函數(shù)： 參數(shù)： typedef{

抓圖數(shù)據(jù) TURE 明：抓取出來的寬高是16的倍

實際大小數(shù)據(jù)buffer大小多加一個reserve選擇區(qū)域NULL,抓取選擇區(qū)域為BMP格 函數(shù)： 參數(shù)： typedef{ TUR