MÉTHODE IMDSPStorageGlobals::GetCapabilities (mswmdm.h)
La méthode GetCapabilities récupère les fonctionnalités du support de stockage auquel un instance de cette interface est associé.
Syntaxe
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
Paramètres
[out] pdwCapabilities
Pointeur vers un DWORD contenant les fonctionnalités du support de stockage.
Les indicateurs suivants peuvent être retournés dans le paramètre pdwCapabilities .
| Indicateur | Description |
|---|---|
| WMDM_STORAGECAP_FOLDERSINROOT | Le support prend en charge les dossiers à la racine du stockage. |
| WMDM_STORAGECAP_FILESINROOT | Le support prend en charge les fichiers à la racine du stockage. |
| WMDM_STORAGECAP_FOLDERSINFOLDERS | Le support prend en charge les dossiers dans les dossiers. |
| WMDM_STORAGECAP_FILESINFOLDERS | Le support prend en charge les fichiers dans les dossiers. |
| WMDM_STORAGECAP_FOLDERLIMITEXISTS | Il existe une limite de nombre arbitraire pour le nombre de dossiers autorisé en fonction de la forme de prise en charge des dossiers par le support. |
| WMDM_STORAGECAP_FILELIMITEXISTS | Il existe une limite de nombre arbitraire pour le nombre de fichiers autorisé par la forme de prise en charge des fichiers par le support. |
| WMDM_STORAGECAP_NOT_INITIALIZABLE | Le support ne peut pas être initialisé. Par défaut, le stockage de niveau supérieur peut être initialisé. |
Pour les implémentations d’appareils sécurisés, les indicateurs suivants décrivant les fonctionnalités de droits du support peuvent également être retournés.
| Indicateur | Description |
|---|---|
| WMDM_RIGHTS_PLAYBACKCOUNT | Le support prend en charge la limitation du nombre de lecture pour le contenu. |
| WMDM_RIGHTS_EXPIRATIONDATE | Le support prend en charge le suivi de la date d’expiration pour le contenu. |
| WMDM_RIGHTS_FREESERIALIDS | Le support prend en charge un identificateur série gratuit pour le fichier. |
| WMDM_RIGHTS_GROUPID | Le support prend en charge un identificateur de groupe pour le fichier. |
| WMDM_RIGHTS_NAMEDSERIALIDS | Le support prend en charge un identificateur série nommé pour le fichier. |
Valeur retournée
Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :
- Codes d’erreur COM standard
- Codes d’erreur Windows convertis en valeurs HRESULT
- Codes d’erreur Gestionnaire de périphériques Windows Media
Notes
Les tentatives d’exécution d’opérations non prises en charge sur le support de stockage avec l’interface IMDSPObject retournent un code d’erreur. La méthode GetCapabilities peut être appelée afin de déterminer si une opération peut être censée réussir dans des circonstances normales.
Si l’indicateur WMDM_STORAGECAP_FILELIMITEXISTS ou l’indicateur WMDM_STORAGECAP_FOLDERLIMITEXISTS est vrai, il existe des limites arbitraires quant au nombre de fichiers ou de dossiers qui peuvent être créés. Les opérations effectuées via l’interface IMDSPObject qui dépassent ces limites échouent.
Cette méthode doit être implémentée. Elle ne doit pas retourner WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.
Configuration requise
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |