ITMSPAddress ::GetEvent, méthode (msp.h)

Article
08/25/2023

La méthode GetEvent récupère les informations d’événement.

Syntaxe

HRESULT GetEvent(
  [in, out] DWORD *pdwSize,
            byte  *pEventBuffer
);

Paramètres

[in, out] pdwSize

Pointeur vers un DWORD qui contient la taille, en octets, de pEventBuffer. En cas de réussite, pdwSize retourne le nombre réel d’octets dans pEventBuffer. Si pEventBuffer n’est pas assez grand, la méthode retourne TAPI_E_NOTENOUGHMEMORY et ce paramètre retourne le nombre, en octets, requis.

pEventBuffer

[in, out, size_is(*pdwSize)] Pointeur vers la mémoire tampon qui contient des informations de event_info MSP .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
E_NOTIMPL	Méthode non implémentée.
E_POINTER	Le paramètre pdwSize ou pEventBuffer n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
TAPI_E_NOTENOUGHMEMORY	Le paramètre pdwSize n’était pas assez grand pour la mémoire tampon.
TAPI_E_NOEVENT	Aucun événement ne s’est produit.

Remarques

TAPI3 appelle cette méthode lorsque le handle d’événement donné dans initialize est signalé. TAPI appelle cette méthode à plusieurs reprises jusqu’à ce qu’elle échoue afin d’obtenir plusieurs événements. Chaque appel ne doit retourner qu’une seule structure d’événements.

Utilisateurs des classes de base MSP : cette méthode verrouille la liste des événements.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	msp.h (inclure Tapi3.h)

Voir aussi

ITMSPAddress

Media Service Provider Interface (MSPI)

Partager via