OPM_CONFIGURE_PARAMETERS 구조체(opmapi.h)

OPM( 출력 보호 관리자 ) 또는 COPP(Certified Output Protection Manager) 명령을 포함합니다.

구문

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

멤버

omac

OPM_MAC 구조체입니다. 이 구조를 명령 데이터의 MAC(메시지 인증 코드)으로 채웁니다. AES 기반 OMAC(원키 CBC MAC)를 사용하여 이 값을 계산합니다.

guidSetting

명령을 지정하는 GUID입니다. 자세한 내용은 OPM 명령을 참조하세요.

ulSequenceNumber

명령 시퀀스 번호입니다. 애플리케이션은 실행 중인 명령 수를 유지해야 합니다. 각 명령에 대해 시퀀스 번호를 하나씩 증분합니다.

IOPMVideoOutput::Configure에 대한 첫 번째 호출에서 ulSequenceNumber를 시작 명령 시퀀스 번호와 같게 설정합니다. 이 번호는 애플리케이션이 IOPMVideoOutput::FinishInitialization을 호출할 때 지정됩니다. 각 후속 호출에서 ulSequenceNumber 를 1씩 증분합니다.

예외: IOPMVideoOutput::Configure 메서드가 실패하는 경우 시퀀스 번호를 증가시키지 마세요. 대신 다음 명령에 동일한 숫자를 다시 사용합니다.

cbParametersSize

abParameters 멤버에 있는 유효한 데이터의 바이트 수입니다.

abParameters[4056]

명령에 대한 데이터입니다. 데이터의 의미는 명령에 따라 달라집니다. 자세한 내용은 OPM 명령을 참조하세요.

설명

이 구조체의 레이아웃은 COPP(Certified Output Protection Protocol)에 사용되는 AMCOPPCommand 구조체와 동일합니다.

다음과 같이 이 구조를 초기화합니다.

1. omac 멤버를 제외한 모든 구조체 멤버를 채웁니다.
2. OMAC 1 알고리즘을 사용하여 omac 멤버( omac 멤버 제외) 다음에 표시되는 데이터 블록에 대한 MAC(메시지 인증 코드)를 계산합니다.
3. MAC을 omac 멤버에 복사합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	opmapi.h

추가 정보

IOPMVideoOutput::Configure

OPM 구조체

출력 보호 관리자