Método IWDFDevice::AssignDeviceInterfaceState (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
El método AssignDeviceInterfaceState habilita o deshabilita la instancia de interfaz de dispositivo especificada para un dispositivo.
Sintaxis
HRESULT AssignDeviceInterfaceState(
[in] LPCGUID pDeviceInterfaceGuid,
[in, optional] PCWSTR pReferenceString,
[in] BOOL Enable
);
Parámetros
[in] pDeviceInterfaceGuid
Puntero al GUID de una clase de interfaz de dispositivo.
[in, optional] pReferenceString
Puntero a un cadena terminada en NULLque contiene el nombre de la instancia de la interfaz de dispositivo. Este parámetro es opcional. El controlador puede pasar NULL si el controlador no tiene que proporcionar un nombre. Si el controlador debe proporcionar un nombre, la cadena que pasa el controlador no debe contener ningún carácter separador de ruta de acceso ("/" o "\").
[in] Enable
Valor BOOL que especifica si la instancia de interfaz del dispositivo debe estar habilitada o deshabilitada. TRUE indica que se va a habilitar; FALSE indica que se deshabilita.
Valor devuelto
AssignDeviceInterfaceState devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.
Observaciones
Si IWDFDevice::CreateDeviceInterface se realiza correctamente, el marco habilita y deshabilita automáticamente la interfaz en función del estado PnP del dispositivo.
Use el método AssignDeviceInterfaceState para deshabilitar y volver a habilitar manualmente una interfaz de dispositivo.
Para obtener más información sobre las interfaces de dispositivo, consulte Using Device Interfaces in UMDF Drivers.
Ejemplos
Para obtener un ejemplo de código de cómo usar el método AssignDeviceInterfaceState, vea IWDFDevice::CreateDeviceInterface.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.5 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |