다음을 통해 공유

IMDSPStorageGlobals::GetCapabilities 메서드(mswmdm.h)

  • 아티클

GetCapabilities 메서드는 이 인터페이스의 instance 연결된 스토리지 매체의 기능을 검색합니다.

구문

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

매개 변수

[out] pdwCapabilities

스토리지 매체의 기능을 포함하는 DWORD 에 대한 포인터입니다.

pdwCapabilities 매개 변수에서 다음 플래그를 반환할 수 있습니다.

플래그 설명
WMDM_STORAGECAP_FOLDERSINROOT 매체는 스토리지 루트의 폴더를 지원합니다.
WMDM_STORAGECAP_FILESINROOT 매체는 스토리지의 루트에 있는 파일을 지원합니다.
WMDM_STORAGECAP_FOLDERSINFOLDERS 이 매체는 폴더의 폴더를 지원합니다.
WMDM_STORAGECAP_FILESINFOLDERS 매체는 폴더의 파일을 지원합니다.
WMDM_STORAGECAP_FOLDERLIMITEXISTS 매체에서 지원하는 폴더 형식에 따라 허용되는 폴더 수에 대한 임의 개수 제한이 있습니다.
WMDM_STORAGECAP_FILELIMITEXISTS 미디어가 지원하는 파일 형식에 따라 허용되는 파일 수에 대한 임의 개수 제한이 있습니다.
WMDM_STORAGECAP_NOT_INITIALIZABLE 매체를 초기화할 수 없습니다. 기본적으로 최상위 스토리지를 초기화할 수 있습니다.
 

보안 디바이스 구현의 경우 매체의 권한 기능을 설명하는 다음 플래그도 반환할 수 있습니다.

플래그 설명
WMDM_RIGHTS_PLAYBACKCOUNT 매체는 콘텐츠에 대한 재생 횟수 제한을 지원합니다.
WMDM_RIGHTS_EXPIRATIONDATE 매체는 콘텐츠에 대한 만료 날짜 추적을 지원합니다.
WMDM_RIGHTS_FREESERIALIDS 매체는 파일에 대한 무료 직렬 식별자를 지원합니다.
WMDM_RIGHTS_GROUPID 매체는 파일에 대한 그룹 식별자를 지원합니다.
WMDM_RIGHTS_NAMEDSERIALIDS 매체는 파일에 대해 명명된 직렬 식별자를 지원합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 디바이스 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스를 반환할 수 있습니다.

  • 표준 COM 오류 코드
  • HRESULT 값으로 변환된 Windows 오류 코드
  • Windows Media 디바이스 관리자 오류 코드
가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

설명

IMDSPObject 인터페이스를 사용하여 스토리지 매체에서 지원되지 않는 작업을 수행하려고 시도하면 오류 코드가 반환됩니다. GetCapabilities 메서드를 호출하여 정상적인 상황에서 작업이 성공할 수 있는지 여부를 확인할 수 있습니다.

WMDM_STORAGECAP_FILELIMITEXISTS 플래그 또는 WMDM_STORAGECAP_FOLDERLIMITEXISTS 플래그가 true이면 만들 수 있는 파일 또는 폴더 수에 대한 임의 제한이 있습니다. 이러한 제한을 초과하는 IMDSPObject 인터페이스를 통한 작업이 실패합니다.

이 메서드를 구현해야 합니다. WMDM_E_NOTSUPPORTED 또는 E_NOTIMPL 반환하지 않아야 합니다. 자세한 내용은 필수 및 선택적 인터페이스를 참조하세요.

요구 사항

   
대상 플랫폼 Windows
헤더 mswmdm.h
라이브러리 Mssachlp.lib

추가 정보

IMDSPStorageGlobals 인터페이스