Attributo SyncState

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'attributo SyncState è una rappresentazione di stringa di un valore a 32 bit che Lettore multimediale Windows usa quando sincronizza le playlist con i dispositivi portatili.

Si applica a

Commenti

Questo attributo è costituito da sedici valori a 2 bit, ognuno dei quali specifica lo stato di sincronizzazione di un dispositivo portatile. Il bit più significativo (MSB) di questo valore a 32 bit corrisponde al dispositivo 16. Il bit meno significativo (LSB) corrisponde al dispositivo 1.

L'MSB di ogni valore a 2 bit indica se Lettore multimediale Windows sincronizzato il contenuto con il dispositivo corrispondente. Il valore 1 indica che l'operazione è stata fatta. Il valore 0 indica che non lo ha fatto.

Se msb è 0, l'LSB specifica il motivo per cui la sincronizzazione non è riuscita. Un valore pari a 1 nell'LSB indica che non è disponibile spazio sufficiente per il contenuto. Un valore 0 nell'LSB indica un altro motivo per cui è stata impedita la sincronizzazione.

Per recuperare lo stato di sincronizzazione di un determinato dispositivo, eseguire le operazioni seguenti:

  1. Richiamare IWMPSyncDevice::get_status per determinare se un determinato dispositivo è sincronizzato.
  2. Se è sincronizzato, richiamare IWMPSyncDevice::get_partnershipIndex per recuperare l'indice della coppia di bit del dispositivo nell'attributo SyncState .
  3. Usando questo indice, mascherare la coppia di bit corrispondente dell'attributo SyncState ed esaminare il risultato per determinare lo stato di sincronizzazione della playlist con il dispositivo.

Per determinare se è possibile modificare il valore di questo attributo, utilizzare il metodo Media.isReadOnlyItem .

Requisiti

Requisito Valore
Versione
Lettore multimediale Windows 10 o versione successiva

Vedi anche

Riferimento agli attributi

Determinazione dello stato di sincronizzazione della playlist

IWMPSyncDevice::get_partnershipIndex

IWMPSyncDevice::get_status