Metodo IKsControl::KsMethod (ks.h)

Il metodo IKsControl::KsMethod invia un metodo a un oggetto KS, insieme a qualsiasi altra operazione di supporto definita disponibile in un set di metodi.

Sintassi

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

Parametri

[in] Method

Puntatore a una struttura KSMETHOD che descrive un metodo e il tipo di richiesta della richiesta del metodo.

[in] MethodLength

Specifica le dimensioni, in byte, del buffer in Metodo.

[in, out] MethodData

Puntatore a un buffer contenente dati e spazio buffer per un'operazione di KSMETHOD_TYPE_SEND o spazio buffer che riceve i dati per tutte le altre operazioni.

[in] DataLength

Specifica le dimensioni, in byte, del buffer in MethodData.

[out] BytesReturned

Puntatore a una variabile che riceve le dimensioni, in byte, dei dati archiviati da KsMethod nel buffer in MethodData.

Valore restituito

Il metodo IKsControl::KsMethod restituisce lo stesso valore che verrebbe restituito se il metodo fosse stato inviato da IOCTL.

Commenti

Per determinare le dimensioni del buffer necessarie per una richiesta di metodo specifica, è possibile chiamare questo metodo con MethodData impostato su NULL e DataLength uguale a zero. Il metodo restituisce HRESULT_FROM_WIN32(ERROR_MORE_DATA e BytesReturned contiene le dimensioni del buffer richiesto.

Requisiti

Vedi anche

KSMETHOD

KSMETHOD_ITEM

KSMETHOD_SET