Compartilhar via

Método IMDSPStorageGlobals::GetCapabilities (mswmdm.h)

  • Artigo

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
Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

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

Confira também

IMDSPStorageGlobals Interface