Compartir a través de

estructura OPM_CONFIGURE_PARAMETERS (opmapi.h)

  • Artículo

Contiene un comando del Administrador de protección de salida (OPM) o certified Output Protection Manager (COPP).

Sintaxis

typedef struct _OPM_CONFIGURE_PARAMETERS {
  OPM_OMAC omac;
  GUID     guidSetting;
  ULONG    ulSequenceNumber;
  ULONG    cbParametersSize;
  BYTE     abParameters[4056];
} OPM_CONFIGURE_PARAMETERS;

Miembros

omac

Estructura OPM_MAC . Rellene esta estructura con el código de autenticación de mensajes (MAC) de los datos del comando. Use CBC MAC (OMAC) basado en AES para calcular este valor.

guidSetting

GUID que especifica el comando . Para obtener más información, consulte Comandos de OPM.

ulSequenceNumber

Número de secuencia de comandos. La aplicación debe mantener un recuento en ejecución de los comandos emitidos. Para cada comando, incremente el número de secuencia en uno.

En la primera llamada a IOPMVideoOutput::Configure, establezca ulSequenceNumber igual al número de secuencia de comandos inicial, que se especifica cuando la aplicación llama a IOPMVideoOutput::FinishInitialization. En cada llamada posterior, incremente ulSequenceNumber en 1.

Excepción: si se produce un error en el método IOPMVideoOutput::Configure , no incremente el número de secuencia. En su lugar, vuelva a usar el mismo número para el siguiente comando.

cbParametersSize

Número de bytes de datos válidos en el miembro abParameters .

abParameters[4056]

Datos del comando. El significado de los datos depende del comando . Para obtener más información, consulte Comandos de OPM.

Comentarios

El diseño de esta estructura es idéntico a la estructura AMCOPPCommand utilizada en el Protocolo de protección de salida certificada (COPP).

Inicialice esta estructura de la siguiente manera.

  1. Rellene todos los miembros de la estructura excepto el miembro omac .
  2. Use el algoritmo OMAC 1 para calcular un código de autenticación de mensajes (MAC) para el bloque de datos que aparece después del miembro omac (excepto el miembro omac ).
  3. Copie el MAC en el miembro omac .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado opmapi.h

Consulte también

IOPMVideoOutput::Configure

Estructuras de OPM

Administrador de protección de salida