Méthode IKsControl ::KsMethod (ksproxy.h)

La méthode KsMethod envoie une méthode à un objet KS, ainsi que toutes les autres opérations de prise en charge définies disponibles sur un ensemble de méthodes.

Syntaxe

HRESULT KsMethod(
  [in]      PKSMETHOD Method,
  [in]      ULONG     MethodLength,
  [in, out] LPVOID    MethodData,
  [in]      ULONG     DataLength,
  [in, out] ULONG     *BytesReturned
);

Paramètres

[in] Method

Pointeur vers une structure KSMETHOD qui décrit une méthode et le type de requête de la demande de méthode.

[in] MethodLength

Taille, en octets, de la mémoire tampon dans Méthode.

[in, out] MethodData

Pointeur vers une mémoire tampon qui contient des données et de l’espace tampon pour une opération de KSMETHOD_TYPE_SEND, ou un espace tampon qui reçoit des données pour toutes les autres opérations.

[in] DataLength

Taille, en octets, de la mémoire tampon sur MethodData.

[in, out] BytesReturned

Pointeur vers une variable qui reçoit la taille, en octets, des données que KsMethod stocke dans la mémoire tampon sur MethodData.

Valeur retournée

Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.

Remarques

Il s’agit d’un appel synchrone. Elle ne se terminera pas tant que la méthode n’est pas terminée à partir du mode noyau.

Pour déterminer la taille de mémoire tampon requise pour une demande de méthode spécifique, vous pouvez appeler cette méthode avec MethodData défini sur NULL et DataLength égal à zéro. La méthode retourne HRESULT_FROM_WIN32(ERROR_MORE_DATA et BytesReturned contient la taille de la mémoire tampon requise.

Configuration requise

Condition requise	Valeur
Plateforme cible	DesktopMobile
En-tête	ksproxy.h (inclure Ksproxy.h)

Voir aussi

KSMETHOD