Método IMDSPEnumDevice::Next (mswmdm.h)
O método Next recupera um ponteiro para as próximas interfaces IMDSPDevice do celt.
Sintaxe
HRESULT Next(
[in] ULONG celt,
[out] IMDSPDevice **ppDevice,
[out] ULONG *pceltFetched
);
Parâmetros
[in] celt
Número de dispositivos solicitados.
[out] ppDevice
Matriz de ponteiros de celtIMDSPDevice alocada pelo chamador. Retornar NULL para indicar que não existe mais dispositivos ou ocorreu 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 o número de interfaces recuperadas.
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
Comentários
Quando não há mais interfaces do provedor de serviços para dispositivos enumerados ou quando há menos dessas interfaces do que as solicitadas pelo parâmetro celt , 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 do dispositivo pode não refletir o efeito da inserção e remoção do dispositivo.
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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | mswmdm.h |
| Biblioteca | Mssachlp.lib |