|
|
| Previous | Next |
The GetCapabilities method retrieves the capabilities of the storage medium that an instance of this interface is associated with..
Syntax
HRESULT GetCapabilities(
DWORD* pdwCapabilities
);
Parameters
pdwCapabilities
[out] Pointer to a double word containing the capabilities of the storage medium.
The following flags can be returned in the pdwCapabilities parameter.
| Flag | Description |
| WMDM_STORAGECAP_FOLDERSINROOT | The medium supports folders in the root of storage. |
| WMDM_STORAGECAP_FILESINROOT | The medium supports files in the root of storage. |
| WMDM_STORAGECAP_FOLDERSINFOLDERS | The medium supports folders in folders. |
| WMDM_STORAGECAP_FILESINFOLDERS | The medium supports files in folders. |
| WMDM_STORAGECAP_FOLDERLIMITEXISTS | There is an arbitrary count limit for the number of folders allowed per the form of folder support by the medium. |
| WMDM_STORAGECAP_FILELIMITEXISTS | There is an arbitrary count limit for the number of files allowed per the form of file support by the medium. |
For secured device implementations, the following flags describing the rights capabilities of the medium are also returned.
| Flag | Description |
| WMDM_RIGHTS_PLAYBACKCOUNT | This medium supports playback count limiting for content. |
| WMDM_RIGHTS_EXPIRATIONDATE | This medium supports expiration date tracking for content. |
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.
| Return code | Description |
| E_INVALIDARG | The pdwCapabilities parameter is an invalid or NULL pointer. |
| E_FAIL | An unspecified error occurred. |
Remarks
Attempts to perform unsupported operations on the storage medium with the IMDSPObject interface returns an error code. The GetCapabilities method can be called in order to determine whether an operation can be expected to succeed under normal circumstances.
If either the WMDM_STORAGECAP_FILELIMITEXISTS flag or the WMDM_STORAGECAP_FOLDERLIMITEXISTS flag are true, there are arbitrary limits on the number of files or folders that can be created. Operations through the IMDSPObject interface that exceed these limits will fail.
See Also
| Previous | Next |