Metodo IWDFDevice::AssignDeviceInterfaceState (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Il metodo AssignDeviceInterfaceState abilita o disabilita l'istanza dell'interfaccia del dispositivo specificata per un dispositivo.
Sintassi
HRESULT AssignDeviceInterfaceState(
[in] LPCGUID pDeviceInterfaceGuid,
[in, optional] PCWSTR pReferenceString,
[in] BOOL Enable
);
Parametri
[in] pDeviceInterfaceGuid
Puntatore al GUID per una classe di interfaccia del dispositivo.
[in, optional] pReferenceString
Puntatore a un NULLstringa con terminazione contenente il nome dell'istanza dell'interfaccia del dispositivo. Questo parametro è facoltativo. Il driver può passare NULL se il driver non deve specificare un nome. Se il driver deve specificare un nome, la stringa passata dal driver non deve contenere caratteri separatori di percorso ("/" o "\").
[in] Enable
Valore BOOL che specifica se l'istanza dell'interfaccia del dispositivo deve essere abilitata o disabilitata. TRUE indica di abilitare; false indica di disabilitare.
Valore restituito
AssignDeviceInterfaceState restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.
Osservazioni
Se IWDFDevice::CreateDeviceInterface ha esito positivo, il framework abilita e disabilita automaticamente l'interfaccia in base allo stato PnP del dispositivo.
Usare il metodo AssignDeviceInterfaceState per disabilitare e riabilitare manualmente un'interfaccia del dispositivo.
Per altre informazioni sulle interfacce dei dispositivi, vedere Using Device Interfaces in UMDF Drivers.For more information about device interfaces, see Using Device Interfaces in UMDF Drivers.
Esempi
Per un esempio di codice su come usare il metodo AssignDeviceInterfaceState, vedere IWDFDevice::CreateDeviceInterface.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.5 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |