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) |