Méthode IWDFRemoteInterfaceInitialize ::GetInterfaceGuid (wudfddi.h)

  • Article

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode GetInterfaceGuid récupère le GUID qui identifie une interface d’appareil.

Syntaxe

void GetInterfaceGuid(
  [out] LPGUID pDeviceInterfaceGuid
);

Paramètres

[out] pDeviceInterfaceGuid

Pointeur vers une structure GUID allouée par le pilote qui reçoit le GUID de l’interface de périphérique.

Valeur de retour

None

Remarques

Pour plus d’informations sur la méthode GetInterfaceGuid , consultez Utilisation d’interfaces de périphérique dans les pilotes basés sur UMDF.

Exemples

L’exemple de code suivant montre comment la fonction de rappel IPnpCallbackRemoteInterfaceNotification ::OnRemoteInterfaceArrival d’un pilote peut obtenir le GUID qui identifie l’interface de périphérique qui est arrivée.

void 
STDMETHODCALLTYPE
CMyDevice::OnRemoteInterfaceArrival(
    __in IWDFRemoteInterfaceInitialize  *FxRemoteInterfaceInit
    )
{
    GUID DeviceInterfaceGUID;
    FxRemoteInterfaceInit->GetInterfaceGuid(&DeviceInterfaceGUID);
...
}

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1,9
En-tête wudfddi.h (inclure Wudfddi.h)
DLL WUDFx.dll

Voir aussi

IWDFRemoteInterfaceInitialize

IWDFRemoteInterfaceInitialize ::RetrieveSymbolicLink