Compartir a través de

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

  • Artículo

El método Next recupera un puntero a las siguientes interfaces IMDSPDevicecelt.

Sintaxis

HRESULT Next(
  [in]  ULONG       celt,
  [out] IMDSPDevice **ppDevice,
  [out] ULONG       *pceltFetched
);

Parámetros

[in] celt

Número de dispositivos solicitados.

[out] ppDevice

Matriz de punteros celtIMDSPDevice asignado por el autor de la llamada. Devuelve NULL para indicar que no existen más dispositivos o se ha producido un error. Si celt es mayor que 1, el autor de la llamada debe asignar suficiente memoria para almacenar el número celt de punteros de interfaz.

[out] pceltFetched

Puntero a una variable ULONG que recibe el número de interfaces recuperadas.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

  • Códigos de error COM estándar
  • Códigos de error de Windows convertidos en valores HRESULT
  • Códigos de error de windows Media Administrador de dispositivos
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Cuando no hay más interfaces de proveedor de servicios para dispositivos enumerados o cuando hay menos interfaces de las solicitadas por el parámetro celt , el valor devuelto de Next es S_FALSE. Cuando esto sucede, se debe consultar el parámetro pceltFetched para determinar cuántas interfaces, si existen, se devolvieron.

Es posible que el enumerador de dispositivos no refleje el efecto de la inserción y eliminación del dispositivo.

Este método debe implementarse. No debe devolver WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

Interfaz IMDSPDevice

Interfaz IMDSPEnumDevice