DrmGetContentRights 함수(drmk.h)

아티클
08/07/2023

함수는 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_CONTENTIDset-property 요청을 통해) 또는 데이터 경로의 이전 모듈(콘텐츠 처리기 호출을 통해)에서 직접 콘텐츠 ID와 콘텐츠 권한을 모두 받습니다. 자세한 내용은 DrmForwardContentToInterface, DrmForwardContentToDeviceObject 및 DrmAddContentHandlers를 참조하세요.

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