VideoCaptureDeviceItem::getSerialNumber Method
デバイスのシリアルナンバーを返します。
構文
bool getSerialNumber( int64_t& id ) const;
int64_t getSerialNumber() const;
パラメータ | 説明 |
---|---|
id | コピーされたデバイスIDを受け取るint64_t 変数。 |
戻り値
シリアル番号の取得に成功した場合はtrue、デバイスがシリアルを提供しない、または持っていない場合はfalse。
シリアル番号の取得に成功した場合 ! = 0、デバイスがシリアル番号を提供していない場合、またはシリアル番号がない場合0。
備考
このメソッドはデバイスのファームウェアより受け取るシリアル番号を返します。ほとんどのデバイスにおいてラベルに印刷された番号は個々で違います。ラベルに印刷されているシリアル番号とこのメソッドが返すシリアル番号に違いがあった場合、どちらかの仕様に変更があり番号が無効になった可能性があります。デバイスを識別するのに一番安全な方法としてはこのメソッドの戻り値(シリアル番号)をプリントするツールを用いてシステムに接続し、使用しているソフトウェア内でのIDとすることです。(下記の例を参照ください)
サンプル
この例は現在選択中のデバイスのシリアル番号の取得と読み取り方法について紹介しています。
iResult.QuadPart = 0;
if( m_Grabber.getDev().getSerialNumber( iResult.QuadPart ) == true )
{
TRACE("Serial number is %I64X\n", iResult.QuadPart);
TRACE("Serial number high part : %d, low part %d\n", iResult.HighPart, iResult.LowPart);
}
else
{
TRACE("Serial number could not be retrieved.\n");
}