Utilizzo di un oggetto IViewHelper Clone-View COM

TMM userà i metodi dell'oggetto interfaccia COM IViewHelper di visualizzazione clone di un fornitore hardware in nuove configurazioni di monitoraggio e monitoraggio persistente. In una configurazione di monitoraggio persistente, TMM ripristina i dati visualizzati, ovvero le modalità di visualizzazione e i dati della topologia, ai monitoraggi. TMM può passare questi dati di visualizzazione al driver di visualizzazione in modalità utente tramite il metodo IViewHelper::SetConfiguration in modo che il driver possa modificare o piegare altri dati di visualizzazione (ad esempio, impostazioni gamma o TV).

Gli errori di una rete vidPN (Video Present Network) vengono restituiti tramite i metodi di IViewHelper. Pertanto, se TMM applica una topologia non corretta, il VidPN ha esito negativo e il risultato dell'errore viene restituito alla funzione chiamante. Il mapping di una destinazione a due origini o l'uso di un identificatore di destinazione o di origine che il VidPN non è in grado di identificare sono esempi di topologia non corretta.

TMM determina l'oggetto interfaccia COM IViewHelper tramite il valore del Registro di sistema stringhe UserModeDriverGUID . I fornitori di hardware devono aggiungere questo valore nelle chiavi del Registro di sistema specificate dal membro DeviceKey della struttura DISPLAY_DEVICE. Una chiamata alla funzione Win32 EnumDisplayDevices restituisce queste informazioni sulla chiave del Registro di sistema in DISPLAY_DEVICE a cui punta il parametro lpDisplayDevice . Se esistono più nomi DeviceKey , questo valore verrà visualizzato in ognuna di queste chiavi. Di seguito è riportato un esempio di chiave del dispositivo e del valore del Registro di sistema stringhe UserModeDriverGUID :

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Video\{7661971C-A9BD-48B5-ACBC-298A8826535D}\0000]
"UserModeDriverGUID"="{YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY}"

Affinché COM carichi l'oggetto interfaccia COM IViewHelper , l'oggetto COM deve essere registrato come gestore in-process (in-process) e il modello di threading deve essere Entrambi. Il GUID registrato deve corrispondere al GUID in UserModeDriverGUID. Per informazioni sull'attributo Entrambi i modelli di threading, vedere la documentazione di Microsoft Windows SDK.

È consigliabile copiare e registrare solo le versioni compilate correttamente delle DLL dell'oggetto interfaccia COM IViewHelper nella directory di sistema. Ciò significa che è necessario copiare e registrare solo la DLL IViewHelper a 64 bit per i sistemi operativi a 64 bit e la DLL IViewHelper a 32 bit per i sistemi operativi a 32 bit. I due file binari DLL non devono essere presenti simultaneamente nello stesso computer. TMM non funzionerà correttamente se i due file binari sono presenti simultaneamente nello stesso computer, anche con Windows in Windows (WOW).