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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[in] Method

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

[in] MethodLength

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

[in, out] MethodData

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

[in] DataLength

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

[in, out] BytesReturned

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

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

Возвращает NOERROR в случае успешного выполнения; в противном случае возвращает код ошибки.

Замечания

Это синхронный вызов. Он не будет завершен до тех пор, пока метод не будет завершен из режима ядра.

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

Требования

Требование	Ценность
целевая платформа	DesktopMobile
заголовка	ksproxy.h (включая Ksproxy.h)

См. также

KSMETHOD

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