Método IMDSPStorageGlobals::GetCapabilities (mswmdm.h)
O método GetCapabilities recupera os recursos do meio de armazenamento ao qual uma instância dessa interface está associada.
Sintaxe
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
Parâmetros
[out] pdwCapabilities
Ponteiro para um DWORD que contém os recursos do meio de armazenamento.
Os sinalizadores a seguir podem ser retornados no parâmetro pdwCapabilities .
| Sinalizador | Descrição |
|---|---|
| WMDM_STORAGECAP_FOLDERSINROOT | O meio dá suporte a pastas na raiz do armazenamento. |
| WMDM_STORAGECAP_FILESINROOT | O meio dá suporte a arquivos na raiz do armazenamento. |
| WMDM_STORAGECAP_FOLDERSINFOLDERS | O meio dá suporte a pastas em pastas. |
| WMDM_STORAGECAP_FILESINFOLDERS | O meio dá suporte a arquivos em pastas. |
| WMDM_STORAGECAP_FOLDERLIMITEXISTS | Há um limite de contagem arbitrária para o número de pastas permitidas de acordo com a forma de suporte de pasta pelo meio. |
| WMDM_STORAGECAP_FILELIMITEXISTS | Há um limite de contagem arbitrária para o número de arquivos permitidos de acordo com a forma de suporte de arquivo pelo meio. |
| WMDM_STORAGECAP_NOT_INITIALIZABLE | O meio não pode ser inicializado. Por padrão, o armazenamento de nível superior pode ser inicializado. |
Para implementações de dispositivo protegidas, os sinalizadores a seguir que descrevem os recursos de direitos do meio também podem ser retornados.
| Sinalizador | Descrição |
|---|---|
| WMDM_RIGHTS_PLAYBACKCOUNT | O meio dá suporte à limitação da contagem de reprodução para conteúdo. |
| WMDM_RIGHTS_EXPIRATIONDATE | O meio dá suporte ao acompanhamento de data de validade para conteúdo. |
| WMDM_RIGHTS_FREESERIALIDS | O meio dá suporte a um identificador serial gratuito para o arquivo. |
| WMDM_RIGHTS_GROUPID | O meio dá suporte a um identificador de grupo para o arquivo. |
| WMDM_RIGHTS_NAMEDSERIALIDS | O meio dá suporte a um identificador serial nomeado para o arquivo. |
Valor retornado
O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:
- Códigos de erro COM padrão
- Códigos de erro do Windows convertidos em valores HRESULT
- Códigos de erro de Gerenciador de Dispositivos do Windows Media
Comentários
As tentativas de executar operações sem suporte no meio de armazenamento com a interface IMDSPObject retornam um código de erro. O método GetCapabilities pode ser chamado para determinar se uma operação pode ter êxito em circunstâncias normais.
Se o sinalizador WMDM_STORAGECAP_FILELIMITEXISTS ou o sinalizador WMDM_STORAGECAP_FOLDERLIMITEXISTS for verdadeiro, haverá limites arbitrários no número de arquivos ou pastas que podem ser criados. As operações por meio da interface IMDSPObject que excedem esses limites falharão.
Esse método deve ser implementado. Ele não deve retornar WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | mswmdm.h |
| Biblioteca | Mssachlp.lib |