Метод IKsControl::KsMethod (ks.h)

Статья
02/07/2025

Метод IKsControl::KsMethod отправляет метод в объект KS вместе с любыми другими определенными операциями поддержки, доступными в наборе методов.

Синтаксис

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

Параметры

[in] Method

Указатель на структуру KSMETHOD, описывающую метод и тип запроса метода.

[in] MethodLength

Задает размер буфера в байтах метода.

[in, out] MethodData

Указатель на буфер, содержащий данные и буферное пространство для операции KSMETHOD_TYPE_SEND или буферного пространства, получающего данные для всех других операций.

[in] DataLength

Задает размер буфера в байтах в MethodData.

[out] BytesReturned

Указатель на переменную, которая получает размер в байтах данных, которые KsMethod хранятся в буфере в MethodData.

Возвращаемое значение

Метод IKsControl::KsMethod возвращает то же значение, которое будет возвращено, если метод был отправлен IOCTL.

Замечания

Чтобы определить размер буфера, необходимый для конкретного запроса метода, можно вызвать этот метод с параметром MethodData, равным NULL и DataLength, равным нулю. Метод возвращает значение HRESULT_FROM_WIN32(ERROR_MORE_DATA и BytesReturned содержит размер требуемого буфера.

Требования

Требование	Ценность
целевая платформа	DesktopMobile
заголовка	ks.h (include Ks.h)

См. также

KSMETHOD

KSMETHOD_ITEM

KSMETHOD_SET

Поделиться через