Функция SwDeviceInterfaceRegister (swdevice.h)

Регистрирует интерфейс устройства для программного устройства и при необходимости задает свойства этого интерфейса.

Синтаксис

HRESULT SwDeviceInterfaceRegister(
  [in]            HSWDEVICE         hSwDevice,
  [in]            const GUID        *pInterfaceClassGuid,
  [in, optional]  PCWSTR            pszReferenceString,
  [in]            ULONG             cPropertyCount,
  [in, optional]  const DEVPROPERTY *pProperties,
  [in]            BOOL              fEnabled,
  [out, optional] PWSTR             *ppszDeviceInterfaceId
);

Параметры

[in] hSwDevice

HSWDEVICE дескриптор на программное устройство, чтобы зарегистрировать интерфейс устройства.

[in] pInterfaceClassGuid

Указатель на GUID класса интерфейса , который именует контракт, который реализует этот интерфейс.

[in, optional] pszReferenceString

Необязательная ссылочная строка, которая отличает несколько интерфейсов одного класса для этого устройства. Этот указатель может быть NULL.

[in] cPropertyCount

Количество структур DEVPROPERTY в массиве pProperties.

[in, optional] pProperties

Необязательный массив структур DEVPROPERTY для свойств, заданных в интерфейсе. Этот указатель может быть NULL.

Задайте эти свойства в интерфейсе после его создания, но перед уведомлением о том, что интерфейс был создан. Дополнительные сведения см. в разделе "Примечания". Этот указатель может быть NULL.

[in] fEnabled

Логическое значение, указывающее, следует ли включить или отключить интерфейс. TRUE для включения; значение FALSE для отключения.

[out, optional] ppszDeviceInterfaceId

Указатель на переменную, которая получает указатель на идентификатор интерфейса устройства для интерфейса. Вызывающий объект должен освободить это значение с помощью SwMemFree. Это значение может быть null, если клиентское приложение не должно получить имя.

Возвращаемое значение

S_OK возвращается, если SwDeviceInterfaceRegister успешно зарегистрирован интерфейс; в противном случае соответствующее значение ошибки.

Замечания

Вы можете вызывать SwDeviceInterfaceRegister только после вызова функции обратного вызова клиентского приложения клиентского приложения, чтобы уведомить клиентское SW_DEVICE_CREATE_CALLBACK приложение о завершении перечисления устройств.

Невозможно вызвать SwDeviceInterfaceRegister для программных устройств, которые указывают возможность SWDeviceCapabilitiesDriverRequired.

Требования

См. также

SwMemFree