Méthode IToc ::GetContext (wmcodecdsp.h)

Article
03/04/2024

La méthode GetContext récupère un bloc d’octets précédemment associé à la table des matières par un appel à SetContext.

Syntaxe

HRESULT GetContext(
  [in, out] DWORD *pdwContextSize,
  [out]     BYTE  *pbtContext
);

Paramètres

[in, out] pdwContextSize

Si pbtContext a la valeur NULL, il s’agit d’un paramètre de sortie qui reçoit la taille, en octets, du bloc de contexte. Si pbtContext n’a pas la valeur NULL, il s’agit d’un paramètre d’entrée qui spécifie la taille, en octets, de la mémoire tampon allouée à l’appelant pointée vers pbtContext.

[out] pbtContext

NULL, ou un pointeur vers une mémoire tampon allouée par l’appelant qui, une fois l’achèvement réussi, reçoit le bloc de contexte.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
MF_E_BUFFERTOOSMALL	La méthode retourne ce code d’erreur si pbtContext n’a pas la valeur NULL et si le bloc de contexte est supérieur à la taille spécifiée par bdwContextSize. Dans ce cas, pdwContextSize sert de paramètre de sortie et reçoit la taille, en octets, de la mémoire tampon requise.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wmcodecdsp.h
DLL	Wmvdspa.dll

Voir aussi

IToc

Partager via