DrmGetContentRights 함수(drmk.h)

아티클
02/04/2022
읽는 데 2분 걸림

이 함수는 DrmGetContentRights DRM 콘텐츠 ID에 할당된 DRM 콘텐츠 권한을 검색합니다.

구문

NTSTATUS DrmGetContentRights(
  [in]  ULONG      ContentId,
  [out] PDRMRIGHTS DrmRights
);

매개 변수

[in] ContentId

DRM 콘텐츠 ID를 지정합니다. 이 매개 변수는 KS 오디오 스트림을 식별합니다.

[out] DrmRights

ContentId로 식별되는 스트림에 할당된 DRM 콘텐츠 권한을 지정합니다. 이 매개 변수는 DRMRIGHTS 구조체에 대한 포인터입니다.

반환 값

DrmGetContentRights 는 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

KS 오디오 필터가 여러 KS 오디오 스트림을 함께 혼합하기 전에 먼저 DrmCreateContentMixed 를 호출하여 복합 스트림에 대한 콘텐츠 ID를 만듭니다. 다음으로, 시스템에서 스트림에 할당한 콘텐츠 권한을 가져오기 위해 호출 DrmGetContentRights 합니다.

콘텐츠 ID를 만드는 KS 필터의 다운스트림에 있는 모듈은 일반적으로 호출 DrmGetContentRights할 필요가 없습니다. 대신 모듈은 시스템( IDrmAudioStream::SetContentId 호출 또는 KSPROPERTY_DRMAUDIOSTREAM_CONTENTID set-property 요청)을 통해 또는 데이터 경로의 이전 모듈(콘텐츠 처리기 호출을 통해)에서 직접 콘텐츠 ID와 콘텐츠 권한을 모두 받습니다. 자세한 내용은 DrmForwardContentToInterface, DrmForwardContentToDeviceObject 및 DrmAddContentHandlers를 참조하세요.

DrmGetContentRights는 PcGetContentRights 및 IDrmPort::GetContentRights와 동일한 함수를 수행합니다. 자세한 내용은 DRM 함수 및 인터페이스를 참조하세요.