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 controladores UMDF nuevos deben escribirse con 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 con 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 una cadena terminada en NULL que contiene el nombre de la instancia de la interfaz del 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 va a deshabilitar.
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.
Comentarios
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 Uso de interfaces de dispositivo en controladores UMDF.
Ejemplos
Para obtener un ejemplo de código de cómo usar el método AssignDeviceInterfaceState , vea IWDFDevice::CreateDeviceInterface.
Requisitos
| Requisito | Value |
|---|---|
| Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Versión mínima de UMDF | 1.5 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |