SwDeviceInterfaceRegister, fonction (swdevice.h)

Inscrit une interface d’appareil pour un appareil logiciel et définit éventuellement des propriétés sur cette interface.

Syntaxe

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

Paramètres

[in] hSwDevice

Le HSWDEVICE de gérer l’appareil logiciel pour inscrire une interface d’appareil.

[in] pInterfaceClassGuid

Pointeur vers le GUID de classe d’interface qui nomme le contrat que cette interface implémente.

[in, optional] pszReferenceString

Chaîne de référence facultative qui différencie plusieurs interfaces de la même classe pour cet appareil. Ce pointeur peut être NULL.

[in] cPropertyCount

Nombre de structures DEVPROPERTY dans le tableau pProperties.

[in, optional] pProperties

Tableau facultatif de DEVPROPERTY structures pour les propriétés à définir sur l’interface. Ce pointeur peut être NULL.

Définissez ces propriétés sur l’interface après sa création, mais avant d’envoyer une notification indiquant que l’interface a été créée. Pour plus d’informations, consultez Remarques. Ce pointeur peut être NULL.

[in] fEnabled

Valeur booléenne qui indique s’il faut activer ou désactiver l’interface. TRUE à activer ; FALSE à désactiver.

[out, optional] ppszDeviceInterfaceId

Pointeur vers une variable qui reçoit un pointeur vers l’ID d’interface de l’appareil pour l’interface. L’appelant doit libérer cette valeur avec SwMemFree. Cette valeur peut être NULL si l’application cliente n’a pas besoin de récupérer le nom.

Valeur de retour

S_OK est retourné si SwDeviceInterfaceRegister a correctement inscrit l’interface ; sinon, valeur d’erreur appropriée.

Remarques

Vous pouvez appeler SwDeviceInterfaceRegister uniquement une fois que le système d’exploitation a appelé la fonction de rappel SW_DEVICE_CREATE_CALLBACK de votre application cliente pour informer l’application cliente de l’énumération de l’appareil terminée.

Vous ne pouvez pas appeler SwDeviceInterfaceRegister pour les appareils logiciels qui spécifient la fonctionnalité SWDeviceCapabilitiesDriverRequired.

Exigences

Voir aussi

SwMemFree