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

O método KsMethod envia um método para um objeto KS, juntamente com quaisquer outras operações de suporte definidas disponíveis em um conjunto de métodos.

Sintaxe

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

Parâmetros

[in] Method

Ponteiro para uma estrutura KSMETHOD que descreve um método e o tipo de solicitação da solicitação de método.

[in] MethodLength

Tamanho, em bytes, do buffer em Método.

[in, out] MethodData

Ponteiro para um buffer que contém dados e espaço de buffer para uma operação de KSMETHOD_TYPE_SEND ou espaço em buffer que recebe dados para todas as outras operações.

[in] DataLength

Tamanho, em bytes, do buffer em MethodData.

[in, out] BytesReturned

Ponteiro para uma variável que recebe o tamanho, em bytes, dos dados armazenados por KsMethod no buffer em MethodData.

Retornar valor

Retorna NOERROR se tiver êxito; caso contrário, retorna um código de erro.

Comentários

Essa é uma chamada síncrona. Ele não será concluído até que o método seja concluído no modo kernel.

Para determinar o tamanho do buffer necessário para uma solicitação de método específica, você pode chamar esse método com MethodData definido como NULL e DataLength igual a zero. O método retorna HRESULT_FROM_WIN32(ERROR_MORE_DATA e BytesReturned contém o tamanho do buffer necessário.

Requisitos

Confira também

KSMETHOD