SyncState 특성

  • 아티클

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

SyncState 특성은 재생 목록을 휴대용 디바이스와 동기화할 때 Windows 미디어 플레이어 사용하는 32비트 값의 문자열 표현입니다.

적용 대상

설명

이 특성은 각각 휴대용 디바이스의 동기화 상태를 지정하는 16개의 2비트 값으로 구성됩니다. 이 32비트 값 중 가장 중요한 비트(MSB)는 디바이스 16에 해당합니다. LSB(최소 비트)는 디바이스 1에 해당합니다.

각 2비트 값의 MSB는 Windows 미디어 플레이어 해당 디바이스와 콘텐츠를 동기화했는지 여부를 나타냅니다. 값이 1이면 해당 값이 그랬다는 것을 나타냅니다. 값이 0이면 그렇지 않음을 나타냅니다.

MSB가 0이면 LSB는 동기화가 실패한 이유를 지정합니다. LSB의 값이 1이면 콘텐츠에 사용 가능한 공간이 충분하지 않음을 나타냅니다. LSB의 값이 0이면 동기화를 방해하는 다른 이유가 있습니다.

지정된 디바이스의 동기화 상태를 검색하려면 다음을 수행해야 합니다.

  1. IWMPSyncDevice::get_status 호출하여 지정된 디바이스가 동기화되는지 여부를 확인합니다.
  2. 동기화된 경우 IWMPSyncDevice::get_partnershipIndex 호출하여 SyncState 특성에서 디바이스의 비트 쌍 인덱스를 검색합니다.
  3. 이 인덱스로 SyncState 특성의 해당 비트 쌍을 마스킹하고 결과를 검사하여 재생 목록의 동기화 상태를 디바이스와 확인합니다.

이 특성의 값을 변경할 수 있는지 여부를 확인하려면 Media.isReadOnlyItem 메서드를 사용합니다.

요구 사항

요구 사항 값
버전
 Windows 미디어 플레이어 10 이상

추가 정보

특성 참조

재생 목록 동기화 상태 확인

IWMPSyncDevice::get_partnershipIndex

IWMPSyncDevice::get_status