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. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con 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 una stringa con terminazione NULL contenente il nome dell'istanza dell'interfaccia del dispositivo. Questo parametro è facoltativo e, Il driver può passare NULL se il driver non deve specificare un nome. Se il driver deve specificare un nome, la stringa che il driver passa 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.

Commenti

Se IWDFDevice::CreateDeviceInterface riesce, il framework abilita e disabilita automaticamente l'interfaccia in base allo stato PnP del dispositivo.

Usare il metodo AssignDeviceInterfaceState per disabilitare e riabilitare un'interfaccia dispositivo manualmente.

Per altre informazioni sulle interfacce del dispositivo, vedere Uso di interfacce dispositivo nei driver UMDF.

Esempio

Per un esempio di codice di come usare il metodo AssignDeviceInterfaceState , vedere IWDFDevice::CreateDeviceInterface.

Requisiti

Vedi anche

IWDFDevice

IWDFDevice::CreateDeviceInterface