Metodo IKsControl::KsProperty (ksproxy.h)
Il metodo KsProperty imposta una proprietà o recupera informazioni sulle 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 un KSPROPERTY o una struttura che contiene una struttura KSPROPERTY come primo membro. Un esempio di struttura a cui può fare riferimento questo membro è la struttura KSPROPERTY_VIDEOPROCAMP_S.
[in] PropertyLength
Dimensioni, in byte, del buffer in corrispondenza di 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 corrispondenza di PropertyData.
[in, out] BytesReturned
Puntatore a una variabile che riceve le dimensioni, in byte, dei dati che KsProperty archivia 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.
Osservazioni
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 byteReturned contiene le dimensioni del buffer richiesto.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | DesktopMobile |
| intestazione | ksproxy.h (include Ksproxy.h) |