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 |