Método IMDSPEnumStorage::Next (mswmdm.h)

Artigo
03/05/2024

O método Next retorna um ponteiro para as próximas interfaces de celtIMDSPStorage .

Sintaxe

HRESULT Next(
  [in]  ULONG        celt,
  [out] IMDSPStorage **ppStorage,
  [out] ULONG        *pceltFetched
);

Parâmetros

[in] celt

Número de interfaces de armazenamento solicitadas.

[out] ppStorage

Matriz de ponteiros de interface IMDSPStoragecelt alocados pelo chamador. Retornará NULL se não houver mais mídia de armazenamento ou se houver um erro. Se o celt for maior que 1, o chamador deverá alocar memória suficiente para armazenar o número celt de ponteiros de interface.

[out] pceltFetched

Ponteiro para uma variável ULONG que recebe a contagem de interfaces retornadas.

Retornar valor

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

Quando não há mais interfaces de armazenamento ou quando há menos interfaces de armazenamento do que as solicitadas, o valor retornado de Next é S_FALSE. Quando isso acontece, o parâmetro pceltFetched deve ser consultado para determinar quantas interfaces, se houver, foram retornadas.

O enumerador de armazenamento pode não refletir o efeito da inserção e remoção de mídia. Nesses casos, o cliente deve obter um novo objeto enumerador.

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.