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

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 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

Confira também

IMDSPDevice Interface

IMDSPEnumDevice Interface