Método IKsControl::KsMethod (ksproxy.h)

  • Artículo

El método KsMethod envía un método a un objeto KS, junto con cualquier otra operación de soporte técnico definida disponible en un conjunto de métodos.

Sintaxis

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

Parámetros

[in] Method

Puntero a una estructura KSMETHOD que describe un método y el tipo de solicitud de la solicitud de método.

[in] MethodLength

Tamaño, en bytes, del búfer en Method.

[in, out] MethodData

Puntero a un búfer que contiene datos y espacio de búfer para una operación de KSMETHOD_TYPE_SEND, o espacio de búfer que recibe datos para todas las demás operaciones.

[in] DataLength

Tamaño, en bytes, del búfer en MethodData.

[in, out] BytesReturned

Puntero a una variable que recibe el tamaño, en bytes, de los datos que KsMethod almacena en el búfer en MethodData.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.

Comentarios

Se trata de una llamada sincrónica. No se completará hasta que el método se complete desde el modo kernel.

Para determinar el tamaño del búfer necesario para una solicitud de método específica, puede llamar a este método con MethodData establecido en NULL y DataLength igual a cero. El método devuelve HRESULT_FROM_WIN32(ERROR_MORE_DATA y BytesReturned contiene el tamaño del búfer necesario.

Requisitos

Requisito Value
Plataforma de destino DesktopMobile
Encabezado ksproxy.h (incluya Ksproxy.h)

Consulte también

KSMETHOD