Condividi tramite


Registrazione delle dipendenze dell'applicazione (Windows Media Format 11 SDK)

[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita da Lettore di origine e Writer sink. Lettore di origine e Writer sink sono stati ottimizzati per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi Lettore di origine e Writer sink anziché Windows Media Format 11 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 API fornite da Windows Media Format SDK o Lettore multimediale Windows 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, l'utente viene invece richiesto con un messaggio che indica 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 in base al quale l'applicazione dipende. È anche possibile impostare due valori aggiuntivi per dipendenza per fornire informazioni aggiuntive sull'applicazione.

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\Descrittore, "APP", "REF_DESCRIPTOR"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\Version, "APP", "WMF_VERSION"

Il valore del Registro di sistema seguente viene usato per registrare la dipendenza dal runtime di 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\Descrittore, "APP", "REF_DESCRIPTOR"
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\Version, "APP", "WMP_VERSION"

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

REF_TYPE

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

APP

Nome o descrittore breve dell'applicazione. Questa stringa non verrà usata 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.

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\WindowsMedia\Setup\DependentRefCounts\App, "SouthridgeVideo", "Southridge Video Player"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Descriptor, "SouthridgeVideo", "Southridge Video Player usa Windows Media Format SDK per riprodurre file video".
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Version, "SouthridgeVideo", "9.0.0.2600"

Considerazioni sul progetto