Condividi tramite


Metodo IMDSPEnumDevice::Next (mswmdm.h)

Il metodo Next recupera un puntatore alle interfacce IMDSPDevicesuccessive.

Sintassi

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

Parametri

[in] celt

Numero di dispositivi richiesti.

[out] ppDevice

Matrice di puntatori NONDSPDevice allocati dal chiamante. Restituisce NULL per indicare che non esistono più dispositivi o si è verificato un errore. Se celt è più di 1, il chiamante deve allocare memoria sufficiente per archiviare il numero di puntatori di interfaccia.

[out] pceltFetched

Puntatore a una variabile ULONG che riceve il numero di interfacce recuperate.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

  • Codici di errore COM standard
  • Codici di errore di Windows convertiti in valori HRESULT
  • Codici di errore di Windows Media Gestione dispositivi
Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Quando non sono presenti più interfacce del provider di servizi per i dispositivi enumerati o quando sono presenti meno interfacce richieste dal parametro celt , il valore restituito da Next è S_FALSE. In questo caso, il parametro pceltFetched deve essere sottoposto a query per determinare il numero di interfacce, se presenti, restituite.

L'enumeratore del dispositivo potrebbe non riflettere l'effetto dell'inserimento e della rimozione del dispositivo.

Questo metodo deve essere implementato. Non deve restituire WMDM_E_NOTSUPPORTED o E_NOTIMPL. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione mswmdm.h
Libreria Mssachlp.lib

Vedi anche

Interfaccia IMDSPDevice

Interfaccia IMDSPEnumDevice