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