Metodo IAMCertifiedOutputProtection::SessionSequenceStart (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il SessionSequenceStart metodo avvia la sessione COPP con il driver grafico.

Sintassi

HRESULT SessionSequenceStart(
  [in] AMCOPPSignature *pSig
);

Parametri

[in] pSig

Puntatore a una struttura AMCOPPSignature . Compilare questa struttura come descritto nella sessione Osservazioni.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
S_OK
 Operazione completata.
E_UNEXPECTED
 Stato non valido. Possibilmente l'applicazione ha passato dati imprevisti o denominati metodi IAMCertifiedOutputProtection nell'ordine errato.
VFW_E_NO_COPP_HW
 Il dispositivo di visualizzazione non supporta COPP; o vmR non è ancora connesso a un dispositivo visualizzato.

Commenti

Per compilare la struttura per il parametro pSig , prima di tutto concatenare i numeri seguenti:

  • Il numero a 128 bit restituito nel parametro pRandom del metodo IAMCertifiedOutputProtection::KeyExchange .
  • Chiave sessione di integrità dei dati. Questo valore è un numero casuale a 128 bit generato dall'applicazione.
  • Numero di sequenza iniziale per le richieste di stato COPP. Questo valore è un numero casuale a 32 bit generato dall'applicazione.
  • Avvio del numero di sequenza per i comandi COPP. Questo valore è un numero casuale a 32 bit generato dall'applicazione.
Crittografare quindi questo numero con crittografia RSA a 2048 bit usando la chiave di crittografia pubblica del driver grafico. La chiave di crittografia pubblica è contenuta nel certificato restituito nel parametro VarLenCertGH del metodo KeyExchange .

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Interfaccia IAMCertifiedOutputProtection

Uso del protocollo COPP (Certified Output Protection Protocol)