Metodo IKsControl::KsProperty (ksproxy.h)

Il metodo KsProperty imposta una proprietà o recupera le informazioni sulla proprietà, insieme a qualsiasi altra operazione di supporto definita disponibile in un set di proprietà.

Sintassi

HRESULT KsProperty(
  [in]      PKSPROPERTY Property,
  [in]      ULONG       PropertyLength,
  [in, out] LPVOID      PropertyData,
  [in]      ULONG       DataLength,
  [in, out] ULONG       *BytesReturned
);

Parametri

[in] Property

Puntatore a una struttura che descrive una proprietà e il tipo di richiesta della richiesta di proprietà. Questa struttura deve essere una struttura KSPROPERTY o una struttura che contiene una struttura KSPROPERTY come primo membro. Un esempio di struttura che può essere puntato da questo membro è la struttura KSPROPERTY_VIDEOPROCAMP_S .

[in] PropertyLength

Dimensioni, in byte, del buffer in Proprietà.

[in, out] PropertyData

Puntatore a un buffer che contiene dati per un'operazione di KSPROPERTY_TYPE_SET, KSPROPERTY_TYPE_UNSERIALIZESET o KSPROPERTY_TYPE_UNSERIALIZERAW o spazio buffer che riceve i dati per tutte le altre operazioni.

[in] DataLength

Dimensioni, in byte, del buffer in PropertyData.

[in, out] BytesReturned

Puntatore a una variabile che riceve le dimensioni, in byte, dei dati archiviati da KsProperty nel buffer in PropertyData. Se non vengono archiviati dati, la dimensione è zero.

Valore restituito

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

Commenti

Per determinare le dimensioni del buffer necessarie per una richiesta di proprietà specifica, è possibile chiamare questo metodo con PropertyData 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

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S