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