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

Статья
08/07/2023

Метод 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 (включая Ks.h)

См. также раздел

KSMETHOD

KSMETHOD_ITEM

KSMETHOD_SET

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