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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | DesktopMobile |
| Intestazione | ksproxy.h (includere Ksproxy.h) |