IKsControl ::KsMethod, méthode (ksproxy.h)

La méthode KsMethod envoie une méthode à un objet KS, ainsi que d’autres opérations de support définies disponibles sur un jeu 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 à méthode.

[in, out] MethodData

Pointeur vers une mémoire tampon qui contient des données et un 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 à MethodData.

[in, out] BytesReturned

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

Valeur de retour

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

Remarques

Il s’agit d’un appel synchrone. Il n’est pas terminé 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.

Exigences

Voir aussi

KSMETHOD