Condividi tramite


Registrazione delle dipendenze dell'applicazione (LETTORE MULTIMEDIALE WINDOWS SDK)

[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.

Le applicazioni che usano le API fornite da Lettore multimediale Windows SDK o Windows Media Format SDK dipendono dai componenti di runtime di tali tecnologie. È possibile registrare l'applicazione come dipendente da tali componenti come parte della configurazione dell'applicazione.

Quando si registra l'applicazione, è possibile scegliere uno dei due livelli di dipendenza: blocco o dipendente. Quando una o più applicazioni vengono registrate con una dipendenza di blocco da uno dei componenti di runtime, il componente verrà bloccato da un rollback a una versione precedente. Le applicazioni dipendenti non registrate come blocco non bloccano il rollback. Prima di eseguire il rollback, viene invece visualizzato un messaggio che informa che le applicazioni dipendono dal componente.

Per registrare l'applicazione, è necessario impostare un valore nel Registro di sistema che identifica l'applicazione. Il valore del Registro di sistema da impostare dipende dal componente da cui dipende l'applicazione. È anche possibile impostare due valori aggiuntivi per ogni dipendenza per fornire informazioni aggiuntive sull'applicazione.

I valori del Registro di sistema seguenti vengono usati per registrare la dipendenza dal runtime Lettore multimediale Windows SDK:

  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\ REF_TYPE \App, "APP", "APP_STRING"
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\ REF_TYPE \Descriptor, "APP", "REF_DESCRIPTOR"
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\ REF_TYPE \Version, "APP", "WMP_VERSION"

I valori del Registro di sistema seguenti vengono usati per registrare la dipendenza dal runtime di Windows Media Format SDK:

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\ REF_TYPE \App, "APP", "APP_STRING"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\ REF_TYPE \Descriptor, "APP", "REF_DESCRIPTOR"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\ REF_TYPE \Version, "APP", "WMF_VERSION"

Le variabili seguenti vengono usate nei valori del Registro di sistema elencati in precedenza:

REF_TYPE

Sostituire con BlockingRefCounts per bloccare la dipendenza o con DependentRefCounts per la dipendenza non bloccante.

APP

Nome o descrittore breve dell'applicazione. Questa stringa non verrà utilizzata nei messaggi visualizzati per l'utente. Questo valore è l'identificatore usato in tutti e tre i valori del Registro di sistema associati a ognuno dei componenti di runtime.

APP_STRING

Descrittore dell'applicazione. Questa stringa può essere usata nei messaggi visualizzati per l'utente.

REF_DESCRIPTOR

Descrizione del modo in cui l'applicazione usa il componente. Questo valore può includere un massimo di 256 caratteri.

WMP_VERSION

Versione di Lettore multimediale Windows richiesta dall'applicazione. Se non viene specificata alcuna versione, si presuppone che il valore predefinito sia 9.0.0.0.

WMF_VERSION

Versione di Windows Media Format SDK richiesta dall'applicazione.

I tre valori del Registro di sistema di esempio seguenti illustrano come configurare i valori per l'applicazione:

  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\DependentRefCounts\App, "SouthridgeVideo", "Southridge Video Player"
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\DependentRefCounts\Descriptor, "SouthridgeVideo", "Southridge Video Player usa Windows Media Format SDK per riprodurre file video".
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\DependentRefCounts\Version, "SouthridgeVideo", "9.0.0.2600"

Impostazioni del Registro di sistema