Metodo IKsControl::KsMethod (ksproxy.h)

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

Sintassi

HRESULT KsMethod(
  [in]      PKSMETHOD Method,
  [in]      ULONG     MethodLength,
  [in, out] LPVOID    MethodData,
  [in]      ULONG     DataLength,
  [in, 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

Dimensioni, in byte, del buffer in Metodo.

[in, out] MethodData

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

[in] DataLength

Dimensioni, in byte, del buffer in MethodData.

[in, out] BytesReturned

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

Valore restituito

Restituisce NOERROR se ha esito positivo; in caso contrario, restituisce un codice di errore.

Commenti

Si tratta di una chiamata sincrona. Non verrà completato fino al completamento del metodo dalla modalità kernel.

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

Requisito	Valore
Piattaforma di destinazione	DesktopMobile
Intestazione	ksproxy.h (includere Ksproxy.h)

Vedi anche

KSMETHOD