SwDeviceInterfaceRegister-Funktion (swdevice.h)

Registriert eine Geräteschnittstelle für ein Softwaregerät und legt optional Eigenschaften für diese Schnittstelle fest.

Syntax

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
);

Parameter

[in] hSwDevice

Die HSWDEVICE auf das Softwaregerät um eine Geräteschnittstelle zu registrieren.

[in] pInterfaceClassGuid

Ein Zeiger auf die GUID der Schnittstellenklasse, die den von dieser Schnittstelle implementierten Vertrag benennt.

[in, optional] pszReferenceString

Eine optionale Referenzzeichenfolge, die mehrere Schnittstellen derselben Klasse für dieses Gerät unterscheidet. Dieser Zeiger kann NULL-sein.

[in] cPropertyCount

Die Anzahl der DEVPROPERTY Strukturen im pProperties Arrays.

[in, optional] pProperties

Ein optionales Array von DEVPROPERTY- Strukturen für die Eigenschaften, die für die Schnittstelle festgelegt werden sollen. Dieser Zeiger kann NULL-sein.

Legen Sie diese Eigenschaften auf der Schnittstelle fest, nachdem sie erstellt wurde, aber bevor eine Benachrichtigung gesendet wird, dass die Schnittstelle erstellt wurde. Weitere Informationen finden Sie in den Anmerkungen. Dieser Zeiger kann NULL-sein.

[in] fEnabled

Ein boolescher Wert, der angibt, ob die Schnittstelle aktiviert oder deaktiviert werden soll. TRUE aktivieren; FALSE- zum Deaktivieren aus.

[out, optional] ppszDeviceInterfaceId

Ein Zeiger auf eine Variable, die einen Zeiger auf die Geräteschnittstellen-ID für die Schnittstelle empfängt. Der Aufrufer muss diesen Wert mit SwMemFreefreigeben. Dieser Wert kann NULL- werden, wenn die Client-App den Namen nicht abrufen muss.

Rückgabewert

S_OK wird zurückgegeben, wenn SwDeviceInterfaceRegister die Schnittstelle erfolgreich registriert hat; andernfalls ein entsprechender Fehlerwert.

Bemerkungen

Sie können SwDeviceInterfaceRegister- erst aufrufen, nachdem das Betriebssystem die SW_DEVICE_CREATE_CALLBACK Rückruffunktion Ihrer Client-App aufgerufen hat, um die Client-App darüber zu informieren, dass die Geräteenumeration abgeschlossen ist.

Sie können SwDeviceInterfaceRegister- nicht für Softwaregeräte aufrufen, die die SWDeviceCapabilitiesDriverRequired--Funktion angeben.

Anforderungen

Siehe auch

SwMemFree