Атрибут SyncState

[Функция, связанная с этой страницей, Медиаплеер Windows sdk, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Атрибут SyncState — это строковое представление 32-разрядного значения, которое Медиаплеер Windows использует при синхронизации списков воспроизведения с переносными устройствами.

Применение

Комментарии

Этот атрибут состоит из шестнадцати 2-разрядных значений, каждое из которых указывает состояние синхронизации переносимого устройства. Самый значительный бит (MSB) этого 32-разрядного значения соответствует устройству 16. Наименьший значимый бит (LSB) соответствует устройству 1.

MsB каждого 2-разрядного значения указывает, синхронизировали ли Медиаплеер Windows содержимое с соответствующим устройством. Значение 1 указывает, что это произошло. Значение 0 указывает, что это не так.

Если MSB равно 0, LSB указывает причину сбоя синхронизации. Значение 1 в LSB указывает, что недостаточно свободного места для содержимого. Значение 0 в LSB указывает на другую причину, по которой синхронизация была запрещена.

Чтобы получить состояние синхронизации данного устройства, выполните следующие действия.

  1. Вызовите IWMPSyncDevice::get_status , чтобы определить, синхронизировано ли данное устройство.
  2. Если он синхронизирован, вызовите IWMPSyncDevice::get_partnershipIndex , чтобы получить индекс битовой пары устройства в атрибуте SyncState .
  3. Используя этот индекс, маскируйте соответствующую битовую пару атрибута SyncState и проверьте результат, чтобы определить состояние синхронизации списка воспроизведения с устройством.

Чтобы определить, можно ли изменить значение этого атрибута, используйте метод Media.isReadOnlyItem .

Требования

Требование Значение
Версия
Медиаплеер Windows 10 или более поздней версии

См. также раздел

Справочник по атрибутам

Определение состояния синхронизации списка воспроизведения

IWMPSyncDevice::get_partnershipIndex

IWMPSyncDevice::get_status