IRemoteInterfaceCallbackEvent ::OnRemoteInterfaceEvent, méthode (wudfddi.h)

[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 fonction de rappel d’événement OnRemoteInterfaceEvent d’un pilote UMDF gère les événements d’appareil associés à une interface d’appareil.

Syntaxe

void OnRemoteInterfaceEvent(
  [in]           IWDFRemoteInterface *pWdfRemoteInterface,
  [in]           REFGUID             EventGuid,
  [in, optional] BYTE                *pbData,
  [in]           DWORD               cbDataSize,
  [in]           DWORD               NameBufferOffset
);

Paramètres

[in] pWdfRemoteInterface

Pointeur vers l’interface IWDFRemoteInterface d’un objet d’interface distante qui représente une interface d’appareil. Le pilote obtient ce pointeur lorsqu’il appelle IWDFDevice2 ::CreateRemoteInterface.

[in] EventGuid

GUID qui identifie le type d’événement. Les GUID d’événement sont définis par les composants qui prennent en charge ces GUID. Certaines classes d’interface d’appareil fournissent des GUID d’événements, et certains pilotes fournissent des événements personnalisés.

[in, optional] pbData

Pointeur vers une mémoire tampon qui contient des données spécifiques à l’événement. En règle générale, les composants qui définissent des GUID d’événements définissent également des structures spécifiques à l’événement pour les mémoires tampons d’événements.

[in] cbDataSize

Taille, en octets, de la mémoire tampon vers laquelle pbData pointe.

[in] NameBufferOffset

Décalage, en octets, à partir du début de la mémoire tampon vers laquelle pbData pointe. Les octets de 0 à NameBufferOffset-1 de la mémoire tampon contiennent des données binaires. Les octets de NameBufferOffset à la fin de la mémoire tampon contiennent des données de chaîne Unicode.

Valeur de retour

None

Remarques

La fonction de rappel d’événement OnRemoteInterfaceEvent d’un pilote gère tous les événements d’appareil, à l’exception des événements d’arrivée et de suppression. Ces événements peuvent provenir d’un appel d’un pilote UMDF à IWDFDevice ::P ostEvent ou d’un appel d’un pilote en mode noyau à IoReportTargetDeviceChange ou IoReportTargetDeviceChangeAsynchronous.

L’infrastructure commence à appeler la fonction de rappel d’événement OnRemoteInterfaceEvent après que le pilote appelle IWDFRemoteTarget ::OpenRemoteInterface et continue à appeler la fonction de rappel jusqu’à ce que la cible d’E/S distante de l’interface de l’appareil soit fermée.

Pour plus d’informations sur la fonction de rappel d’événement OnRemoteInterfaceEvent d’un pilote, consultez Utilisation d’interfaces de périphérique dans les pilotes basés sur UMDF.

Configuration requise

Voir aussi

IPnpCallbackRemoteInterfaceNotification ::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval ::OnRemoteInterfaceRemoval