Metodo IOPMVideoOutput::Configure (opmapi.h)

  • Articolo

Configura un output video. Questo metodo invia un comando OPM (Output Protection Manager) o Certified Output Protection Protocol (COPP) al driver.

Sintassi

HRESULT Configure(
  [in] const OPM_CONFIGURE_PARAMETERS *pParameters,
  [in] ULONG                          ulAdditionalParametersSize,
  [in] const BYTE                     *pbAdditionalParameters
);

Parametri

[in] pParameters

Puntatore a una struttura OPM_CONFIGURE_PARAMETERS contenente il comando. Per un elenco di comandi OPM, vedere Comandi OPM.

[in] ulAdditionalParametersSize

Dimensioni del buffer pbAdditionalParameters , in byte.

[in] pbAdditionalParameters

Puntatore a un buffer contenente informazioni aggiuntive per il comando.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo equivale al metodo IAMCertifiedOutputProtection::P rotectionCommand in COPP.

Questo metodo supporta sia la semantica OPM che la semantica COPP. La semantica COPP è supportata per la compatibilità con le versioni precedenti; le nuove applicazioni devono usare la semantica OPM.

Semantica OPM

Alcuni comandi OPM richiedono informazioni di configurazione aggiuntive da passare nel parametro pbAdditionalParameters . Il parametro ulAdditionalParametersSize specifica le dimensioni dei dati aggiuntivi.

Semantica COPP

Il parametro pbAdditionalParameters deve essere NULL e ulAdditionalParametersSize deve essere zero.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione opmapi.h

Vedi anche

IOPMVideoOutput

Output Protection Manager