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

Consulte también

IWDFDevice

IWDFDevice::CreateDeviceInterface