IMDSPDevice::GetSerialNumber メソッド (mswmdm.h)
GetSerialNumber メソッドは、デバイスを一意に識別するシリアル番号を取得します。
構文
HRESULT GetSerialNumber(
[out] PWMDMID pSerialNumber,
[in, out] BYTE [8] abMac
);
パラメーター
[out] pSerialNumber
デバイスのシリアル番号を受け取る WMDMID 構造体へのポインター。 このパラメーターは、出力メッセージ認証コードに含まれています。
[in, out] abMac
このメソッドのパラメーター データのメッセージ認証コードを含む 8 バイトの配列。 (WMDM_MAC_LENGTHは 8 と定義されています。
戻り値
このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。
- 標準 COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media デバイス マネージャーエラー コード
注釈
すべてのメディア デバイスでシリアル番号がサポートされているわけではありません。 デバイスがシリアル番号をサポートしているかどうかを判断するには、このメソッドを呼び出すときに常にリターン コードをチェックします。 メディア デバイスがシリアル番号をサポートしている場合、メディア デバイスのシリアル番号は一意であることが保証されます。
このメソッドは省略可能です。 保護されたコンテンツを転送する場合、Windows Media デバイス マネージャーは IMDSPStorageGlobals::GetSerialNumber を使用します。 詳細については、「 必須インターフェイスとオプション インターフェイス」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | mswmdm.h |
Library | Mssachlp.lib |