Metodo IKsControl::KsProperty (ks.h)
Il metodo IKsControl::KsProperty imposta una proprietà o recupera informazioni sulle proprietà, insieme a qualsiasi altra operazione di supporto definita disponibile in un set di proprietà.
Sintassi
NTSTATUS KsProperty(
[in] PKSPROPERTY Property,
[in] ULONG PropertyLength,
[in, out] PVOID PropertyData,
[in] ULONG DataLength,
[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
Specifica le 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
Specifica le dimensioni, in byte, del buffer in PropertyData.
[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
Il metodo IKsControl::KsProperty restituisce lo stesso valore che verrebbe restituito se la proprietà fosse stata inviata da IOCTL.
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 | ks.h (include Ks.h) |