OWLIFT C Library for Windows: Getting and Releasing Device
OWLIFT C Library for Windows  1.9.3
Top Page
関数
Getting and Releasing Device

関数

OwStatus_t OwLib_GetDevices (OwDev **devsp, int *numDevsp, OwHostErrorCode_t *hep)
 
OwStatus_t OwLib_GetDevicesDiff (OwDev **newDevsp, int *numNewDevsp, OwDev **removedDevsp, int *numRemovedDevsp, OwDev *oldDevs, int numOldDevs, OwHostErrorCode_t *hep)
 
OwStatus_t OwLib_GetDeviceByCaptureFilter (void *baseFilter, OwDev *devp, OwHostErrorCode_t *hep)
 
OwStatus_t OwLib_CreateWithoutConnect (OwDev *devp)
 
void OwLib_Release (OwDev dev)
 
void OwLib_ReleaseArray (OwDev *devs)
 
OwStatus_t OwLib_Reconnect (OwDev dev)
 

詳解

関数詳解

◆ OwLib_CreateWithoutConnect()

OwStatus_t OwLib_CreateWithoutConnect ( OwDev devp)

デバイスと関連付かない OwDev オブジェクトを生成します。 生成したオブジェクトは OWLIFT SDK 経由ではない DirectShow や V4L2 をソースとした 画像の取得を行った場合に、OwLib_Decode() を呼び出すためだけに使うことができます。

引数
devp[out] オブジェクトの格納先。
戻り値
エラーコード。

◆ OwLib_GetDeviceByCaptureFilter()

OwStatus_t OwLib_GetDeviceByCaptureFilter ( void *  baseFilter,
OwDev devp,
OwHostErrorCode_t hep 
)

指定の DirectShow のキャプチャフィルタに対応するデバイスハンドルを取得します。 キャプチャフィルタが操作可能なデバイスではないときは、OWST_DEVICE_NOT_FOUND を返します。

引数
baseFilter[in] IBaseFilter*型のキャプチャフィルタを表すオブジェクト。
devp[out] デバイスハンドルが格納されます。
hep[out] 戻り値が OWST_DIRECTSHOW_ERROR のとき、DirectShow のエラーコードが格納されます。
戻り値
エラーコード。

◆ OwLib_GetDevices()

OwStatus_t OwLib_GetDevices ( OwDev **  devsp,
int *  numDevsp,
OwHostErrorCode_t hep 
)

デバイスを取得します。 デバイスが見つからないときは OWST_DEVICE_NOT_FOUND を返します。 デバイスのファームウェアのバージョンが不正なとき、OWST_DEVICE_UNSUPPORTED を返します。 OWST_DEVICE_UNSUPPORTED が返されたときは、無効な状態のデバイスハンドルが devsp に格納されます。 無効な状態のデバイスハンドルに対しては、OwLib_GetFirmwareVersion() などのプロパティを取得する いくつかの関数と、OwLib_Release() 以外は実行できません。

引数
devsp[out] 取得したデバイスハンドルが格納されます。 *devsp の解放と、*devsp に格納された個々のデバイスハンドルの解放は呼び出し側の責任です。 *devsp の解放は OwLib_ReleaseArray() によって行います。 *devsp に格納された個々のデバイスハンドルの解放は OwLib_Release() によって行います。
numDevsp[out] 取得したデバイスハンドルの個数が格納されます。
hep[out] 戻り値が OWST_DIRECTSHOW_ERROR のとき、DirectShow のエラーコードが格納されます。
戻り値
エラーコード。

◆ OwLib_GetDevicesDiff()

OwStatus_t OwLib_GetDevicesDiff ( OwDev **  newDevsp,
int *  numNewDevsp,
OwDev **  removedDevsp,
int *  numRemovedDevsp,
OwDev oldDevs,
int  numOldDevs,
OwHostErrorCode_t hep 
)

新しく接続したデバイスの取得と、切断したデバイスの検出を行います。 デバイスが見つからないときは OWST_DEVICE_NOT_FOUND を返します。 デバイスのファームウェアのバージョンが不正なとき、OWST_DEVICE_UNSUPPORTED を返します。 OWST_OK または OWST_DEVICE_NOT_FOUND または OWST_DEVICE_UNSUPPORTED が返されたとき、 newDevsp、 numNewDevsp、 removedDevsp、 numRemovedDevsp には値が格納されます。

引数
newDevsp[out] 新しく接続したデバイスハンドルが格納されます。 新しく接続したデバイスハンドルが存在しないときは NULL が格納されます。 *newDevsp の解放と、*newDevsp に格納された個々のデバイスハンドルの解放は呼び出し側の責任です。 *newDevsp の解放は OwLib_ReleaseArray() によって行います。 *newDevsp に格納された個々のデバイスハンドルの解放は OwLib_Release() によって行います。
numNewDevsp[out] *newDevspに格納されたデバイスハンドルの個数が格納されます。
removedDevsp[out] oldDevs に格納されたデバイスハンドルのうち、切断したデバイスハンドルが格納されます。 切断したデバイスハンドルが存在しないときは NULL が格納されます。 *removedDevsp の解放と、*removedDevsp に格納された個々のデバイスハンドルの解放は呼び出し側の責任です。 *removedDevsp の解放は OwLib_ReleaseArray() によって行います。
numRemovedDevsp[out] *removedDevspに格納されたデバイスハンドルの個数が格納されます。 removedDevsp が NULL のときは NULL 指定可。
oldDevs[in] 取得済みのデバイスハンドルの配列を指定します。 NULL を指定した場合、切断の検知は行いません。
numOldDevs[in] oldDevs に格納されたデバイスハンドルの個数を指定します。
hep[out] OwLib_GetDevices() の hep を参照してください。
戻り値
エラーコード。

◆ OwLib_Reconnect()

OwStatus_t OwLib_Reconnect ( OwDev  dev)

ソフトウェア上でデバイスをホストから一旦切断し、再接続します。 Type-F においてはファームウェアバージョン 3.1 以降で使用可能です。

引数
dev[in] デバイスハンドル。
戻り値
エラーコード。

◆ OwLib_Release()

void OwLib_Release ( OwDev  dev)

デバイスハンドルを解放します。

引数
dev[in] デバイスハンドル。

◆ OwLib_ReleaseArray()

void OwLib_ReleaseArray ( OwDev devs)

デバイスハンドルの配列を解放します。配列に格納された各デバイスハンドルは解放されません。

引数
devs[in] デバイスハンドルの配列。