estrutura OPM_GET_INFO_PARAMETERS (ksopmapi.h)

  • Artigo

Contém parâmetros para o método IOPMVideoOutput::GetInformation .

Sintaxe

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;

Membros

omac

Uma estrutura OPM_OMAC que contém um MAC (código de autenticação de mensagem) para os dados no restante da estrutura.

rnRandomNumber

Uma estrutura OPM_RANDOM_NUMBER que contém um número aleatório de 128 bits criptograficamente seguro.

guidInformation

Um GUID que define a solicitação de status. Para obter mais informações, consulte Solicitações de status do OPM.

ulSequenceNumber

O status número de sequência. O aplicativo deve manter uma contagem em execução de solicitações status. Para cada solicitação, incremente o número de sequência em 1.

Na primeira chamada para GetInformation, defina ulSequenceNumber igual ao número de sequência de status inicial, que é especificado quando o aplicativo chama IOPMVideoOutput::FinishInitialization. Em cada chamada subsequente, incremente ulSequenceNumber em 1.

Exceção: se a solicitação status falhar, não incremente o número de sequência. Em vez disso, reutilize o mesmo número para a próxima solicitação de status.

cbParametersSize

O número de bytes de dados válidos no membro abParameters .

abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE]

Os dados da solicitação de status. O significado dos dados depende da solicitação. Para obter mais informações, consulte Solicitações de status do OPM.

Comentários

Inicialize essa estrutura da seguinte maneira:

  1. Gere um número aleatório de 128 bits criptograficamente seguro e copie-o para o membro rnRandomNumber . Não reutilização desse número depois de chamar GetInformation.
  2. Preencha os membros restantes da estrutura, exceto o membro omac .
  3. Use o algoritmo OMAC 1 para calcular um MAC (código de autenticação de mensagem) para o bloco de dados que aparece após o membro omac (excluindo o membro omac ).
  4. Copie o MAC para o membro omac .

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho ksopmapi.h (inclua Opmapi.h)

Confira também

Estruturas OPM

Gerenciador de Proteção de Saída