DirectShow DirectShow 레퍼런스 인터페이스 IDvdInfo2 GetCurrentUOPS   [목차열람] [주소복사] [슬롯비우기]
IDvdInfo2::GetCurrentUOPS
 
Microsoft DirectX 9.0

IDvdInfo2::GetCurrentUOPS

GetCurrentUOPS 메서드는, 컨텐츠의 생성자가 명시적으로 무효로 한 네비게이션 커멘드가 현재의 디스크 위치에 있으면, 그것을 나타내는 플래그세트를 얻어온다.

구문

HRESULT GetCurrentUOPS(
  ULONG *pulUOPs
);

파라미터

pulUOPs

[out] VALID_UOP_FLAG 값의 비트마다 OR 인 ULONG 형의 변수의 포인터. 각각의 비트는, 사용자 조작 (UOP) 상태 (유효 또는 무효)를 나타낸다. 비트가 설정되어 있으면, 사용자 조작은 금지되고 있다. 「주의」를 참조.

반환값

다음의 몇개의 HRESULT 값을 돌려준다.

반환 코드 설명
S_OK 성공.
E_POINTER pulUOPs 가 유효한 포인터는 아니다.

주의

DVD 의 생성자는, 디스크 위에의 거의 모든 위치에서, UOP 커멘드를 삽입하는 것으로써, 보통은 현재의 DVD 도메인내에서 허가되고 있는 네비게이션 커멘드를 금지할 수 있다. 즉, UOP 커멘드를 이용 하면, 디스크의 생성자는, 보통의 네비게이션 권한을 오버라이드(override) 할 수 있다.

DVD 네비게이터는, 커멘드를 처리하기 전에 자동적으로 모든 UOP 권한을 체크해, 커멘드가 현재의 UOP 에 의해 무효가 되어 있으면, 어느 메서드로부터에서도 VFW_E_DVD_OPERATION_INHIBITED 를 돌려주기 (위해)때문에, 보통은 DVD 프레이야아프리케이쇼가 이 메서드를 사용할 필요는 없다. 애플리케이션으로 현재의 UOP 권한 그 자체를 추적할 필요가 있는 경우는, 현재의 UOP 권한이 필요하게 될 때마다 GetCurrentUOPS 를 호출하는지, 또는, 메시지 루프로 EC_DVD_VALID_UOPS_CHANGE 이벤트 통지를 처리해,lParam1 인수로부터 UOP 정보를 취득할 수 있다. 일반적으로, 후자의 방식이 효율이 좋다.

참조

↑TOP