estructura OPM_GET_INFO_PARAMETERS (ksopmapi.h)

Contiene parámetros para el método IOPMVideoOutput::GetInformation .

Sintaxis

typedef struct _OPM_GET_INFO_PARAMETERS {
  OPM_OMAC          omac;
  OPM_RANDOM_NUMBER rnRandomNumber;
  GUID              guidInformation;
  ULONG             ulSequenceNumber;
  ULONG             cbParametersSize;
  BYTE              abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE];
} OPM_GET_INFO_PARAMETERS;

Members

omac

Estructura OPM_OMAC que contiene un código de autenticación de mensajes (MAC) para los datos del resto de la estructura.

rnRandomNumber

Estructura de OPM_RANDOM_NUMBER que contiene un número aleatorio de 128 bits seguro criptográficamente.

guidInformation

GUID que define la solicitud de estado. Para obtener más información, consulte Solicitudes de estado de OPM.

ulSequenceNumber

Número de secuencia de estado. La aplicación debe mantener un recuento en ejecución de las solicitudes de estado. Para cada solicitud, incremente el número de secuencia en 1.

En la primera llamada a GetInformation, establezca ulSequenceNumber igual al número de secuencia de estado 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 la solicitud de estado, no incremente el número de secuencia. En su lugar, vuelva a usar el mismo número para la siguiente solicitud de estado.

cbParametersSize

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

abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE]

Datos de la solicitud de estado. El significado de los datos depende de la solicitud. Para obtener más información, consulte Solicitudes de estado de OPM.

Comentarios

Inicialice esta estructura de la siguiente manera:

1. Genere un número aleatorio de 128 bits seguro criptográficamente y cópielo en el miembro rnRandomNumber . No vuelva a usar este número después de llamar a GetInformation.
2. Rellene los miembros restantes de la estructura, excepto el miembro omac .
3. 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 ).
4. Copie el MAC en el miembro omac .

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	ksopmapi.h (incluya Opmapi.h)

Consulte también

Estructuras de OPM

Administrador de protección de salida