Partager via

IWMDMStorageGlobals::GetCapabilities

  • Article
banner art

The GetCapabilities method retrieves the capabilities of the storage medium with which an instance of this interface is associated.

Syntax

HRESULT GetCapabilities(
  DWORD*  pdwCapabilities
);

Parameters

pdwCapabilities

[out]  Pointer to a DWORD to receive the capabilities of the storage medium.

Return Values

The method returns an HRESULT. All the interface methods in Windows Media Device Manager and service provider can return any of the following classes of error codes:

  • Standard COM error codes
  • Windows error codes converted to HRESULT values
  • Windows Media Device Manager error codes

For a complete list of possible error codes, see Error Codes.

Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
E_INVALIDARG The pdwCapabilities parameter is an invalid or NULL pointer.
E_FAIL An unspecified error occurred.
WMDM_E_NOT_CERTIFIED The caller is not certified.

Remarks

The retrieved capability code is a combination (using the bitwise EXCLUSIVE OR) of any of the values in the following table.

Capability code 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.
WMDM_STORAGECAP_NOT_INITIALIZABLE The medium can not be initialized. The top-level storage can be formatted by default.

Requirements

Header: Defined in wmdm.idl.

Library: mssachlp.lib

See Also