Share via

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

  • Статья

Метод 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