IDrmAudioStream::SetContentId 메서드(drmk.h)

아티클
02/26/2024

메서드는 SetContentId KS 오디오 스트림에서 DRM 콘텐츠 ID 및 할당된 DRM 콘텐츠 권한을 설정합니다.

구문

NTSTATUS SetContentId(
  [in] ULONG       ContentId,
  [in] PCDRMRIGHTS DrmRights
);

매개 변수

[in] ContentId

DRM 콘텐츠 ID를 지정합니다. 이 매개 변수는 DRM 시스템이 런타임에 생성하여 이 스트림에서 DRM으로 보호되는 콘텐츠를 식별하는 식별자입니다.

[in] DrmRights

이 스트림에서 DRM 으로 보호되는 콘텐츠를 재생하고 복사하기 위해 콘텐츠 공급자가 사용자에게 부여한 권한을 지정하는 DRMRIGHTS 구조체에 대한 포인터입니다.

반환 값

SetContentId 는 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다. 필터가 지정된 콘텐츠 권한을 적용할 수 없는 경우 메서드는 STATUS_NOT_IMPLEMENTED 반환합니다.

설명

DRM 시스템은 KS 오디오 스트림의 SetContentId 수명 동안 언제든지 메서드를 호출할 수 있습니다.

KS 오디오 필터는 메서드에 대한 호출 SetContentId 실행을 동기적으로 완료합니다. 함수가 STATUS_SUCCESS 반환하는 경우 이는 KS 오디오 스트림의 모든 다운스트림 KS 오디오 노드( 오디오 토폴로지 노드 참조)도 지정된 DRM 콘텐츠 ID 및 DRM 콘텐츠 권한으로 성공적으로 구성되었음을 나타냅니다. (다운스트림 노드라는 용어는 오디오 스트림에 대한 직접 또는 간접 싱크를 나타냅니다.)

KS 오디오 필터가 지정된 DRM 콘텐츠 권한을 적용할 수 없는 경우 메서드는 SetContentId 오류 코드 STATUS_NOT_IMPLEMENTED 반환합니다. 이 경우 KS 오디오 스트림의 이전에 설정된 DRM 콘텐츠 ID 및 DRM 콘텐츠 권한은 스트림에 설정된 상태로 유지됩니다.

이 방법을 사용하는 방법에 대한 자세한 내용은 디지털 권한 관리를 참조하세요.