Metodo IMDServiceProvider2::CreateDevice (mswmdm.h)
Il metodo CreateDevice viene chiamato dal Gestione dispositivi di Windows Media per ottenere gli oggetti IMDSPDevice corrispondenti al dispositivo canonico ottenuto dal sottosistema PnP. Questo metodo deve essere implementato per il supporto di PnP e Esplora risorse, ma in caso contrario è facoltativo. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.
Sintassi
HRESULT CreateDevice(
[in] LPCWSTR pwszDevicePath,
[out] DWORD *pdwCount,
[out] IMDSPDevice ***pppDeviceArray
);
Parametri
[in] pwszDevicePath
Puntatore a una stringa con terminazione Null a caratteri wide contenente il percorso del dispositivo rilevato da Windows Media Gestione dispositivi. Questo nome viene ottenuto dal sottosistema PnP ed è il nome canonico più "$ # ", dove # è un numero incrementato automaticamente. Questo nome può essere passato direttamente a funzioni come CreateFile per ottenere l'accesso all'oggetto dispositivo kernel sottostante. Il provider di servizi deve creare uno o più oggetti IMDSPDevice wrapper per questo dispositivo.
[out] pdwCount
Puntatore a un DWORD contenente il numero di oggetti IMDSPDevice creati.
[out] pppDeviceArray
Matrice di interfacce IMDSPDevice che rappresentano i dispositivi. In genere, esiste un solo elemento di matrice, ma un provider di servizi può creare più di un oggetto IMDSPDevice corrispondente a un nome di percorso del dispositivo se crea un oggetto IMDSPDevice per ogni risorsa di archiviazione di primo livello. Ciò è soggetto a modifiche future e il conteggio può essere limitato a 1.
Valore restituito
Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce i codici di errore di Windows Media Gestione dispositivi.
Commenti
Windows Media Gestione dispositivi chiama questo metodo all'avvio di un'applicazione o quando un dispositivo conforme Plug and Play si connette al computer.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |