Método IMDSPStorageGlobals::GetCapabilities (mswmdm.h)
El método GetCapabilities recupera las funcionalidades del medio de almacenamiento al que está asociada una instancia de esta interfaz.
Sintaxis
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
Parámetros
[out] pdwCapabilities
Puntero a un DWORD que contiene las funciones del medio de almacenamiento.
Las marcas siguientes se pueden devolver en el parámetro pdwCapabilities .
| Marca | Descripción |
|---|---|
| WMDM_STORAGECAP_FOLDERSINROOT | El medio admite carpetas en la raíz del almacenamiento. |
| WMDM_STORAGECAP_FILESINROOT | El medio admite archivos en la raíz del almacenamiento. |
| WMDM_STORAGECAP_FOLDERSINFOLDERS | El medio admite carpetas en carpetas. |
| WMDM_STORAGECAP_FILESINFOLDERS | El medio admite archivos en carpetas. |
| WMDM_STORAGECAP_FOLDERLIMITEXISTS | Hay un límite de recuento arbitrario para el número de carpetas permitidas por la forma de compatibilidad con carpetas por medio. |
| WMDM_STORAGECAP_FILELIMITEXISTS | Hay un límite de recuento arbitrario para el número de archivos permitidos según la forma de compatibilidad con archivos por medio. |
| WMDM_STORAGECAP_NOT_INITIALIZABLE | No se puede inicializar el medio. De forma predeterminada, se puede inicializar el almacenamiento de nivel superior. |
En el caso de las implementaciones de dispositivos protegidos, también se pueden devolver las marcas siguientes que describen las funcionalidades de derechos del medio.
| Marca | Descripción |
|---|---|
| WMDM_RIGHTS_PLAYBACKCOUNT | El medio admite la limitación del recuento de reproducción para el contenido. |
| WMDM_RIGHTS_EXPIRATIONDATE | El medio admite el seguimiento de fechas de expiración para el contenido. |
| WMDM_RIGHTS_FREESERIALIDS | El medio admite un identificador de serie libre para el archivo. |
| WMDM_RIGHTS_GROUPID | El medio admite un identificador de grupo para el archivo. |
| WMDM_RIGHTS_NAMEDSERIALIDS | El medio admite un identificador de serie con nombre para el archivo. |
Valor devuelto
El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:
- Códigos de error COM estándar
- Códigos de error de Windows convertidos en valores HRESULT
- Códigos de error de windows Media Administrador de dispositivos
Comentarios
Los intentos de realizar operaciones no admitidas en el medio de almacenamiento con la interfaz IMDSPObject devuelven un código de error. Se puede llamar al método GetCapabilities para determinar si se puede esperar que una operación se realice correctamente en circunstancias normales.
Si la marca de WMDM_STORAGECAP_FILELIMITEXISTS o la marca de WMDM_STORAGECAP_FOLDERLIMITEXISTS es true, hay límites arbitrarios en el número de archivos o carpetas que se pueden crear. Se producirá un error en las operaciones a través de la interfaz IMDSPObject que supere estos límites.
Este método debe implementarse. No debe devolver WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Para obtener más información, consulte Interfaces obligatorias y opcionales.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | mswmdm.h |
| Library | Mssachlp.lib |