Méthode IKsControl ::KsMethod (ks.h)
La méthode IKsControl ::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
NTSTATUS KsMethod(
[in] PKSMETHOD Method,
[in] ULONG MethodLength,
[in, out] PVOID MethodData,
[in] ULONG DataLength,
[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
Spécifie la 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
Spécifie la taille, en octets, de la mémoire tampon dans MethodData.
[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
La méthode IKsControl ::KsMethod retourne la même valeur que celle qui serait retournée si la méthode avait été envoyée par IOCTL.
Remarques
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 | ks.h (inclure Ks.h) |