Metodo IKsPropertySet::Get (ksproxy.h)

Articolo
02/07/2025

Il metodo Get recupera una proprietà identificata da un GUID del set di proprietà e da un identificatore di proprietà.

Sintassi

HRESULT Get(
  [in]  REFGUID PropSet,
  [in]  ULONG   Id,
  [in]  LPVOID  InstanceData,
  [in]  ULONG   InstanceLength,
  [out] LPVOID  PropertyData,
  [in]  ULONG   DataLength,
  [out] ULONG   *BytesReturned
);

Parametri

[in] PropSet

GUID che identifica il set di proprietà.

[in] Id

Identificatore della proprietà all'interno del set di proprietà.

[in] InstanceData

Puntatore ai dati dell'istanza per la proprietà .

[in] InstanceLength

Dimensioni, in byte, del buffer in InstanceData.

[out] PropertyData

Puntatore a un buffer che riceve il valore della proprietà.

[in] DataLength

Dimensioni, in byte, del buffer in corrispondenza di PropertyData.

[out] BytesReturned

Puntatore a una variabile che riceve le dimensioni, in byte, dei dati archiviati Get nel buffer in PropertyData.

Valore restituito

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

Osservazioni

Per recuperare una proprietà, allocare un buffer, che Get riempie con la proprietà . Per determinare le dimensioni del buffer necessarie, specificare NULL per PropertyData e zero per DataLength. Il metodo Get restituisce le dimensioni del buffer necessarie in ByteReturned.

Avvertimento

I file di intestazione ksproxy.h e dsound.h definiscono versioni simili ma incompatibili dell 'interfaccia IKsPropertySet. Le applicazioni che richiedono il modulo proxy KS devono usare la versione definita in ksproxy.h. Se un'applicazione deve includere sia ksproxy.h che dsound.h, quale file di intestazione il compilatore analizza per primo è quello la cui definizione di IKsPropertySet viene usata dal compilatore.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	ksproxy.h (include Ksproxy.h, Dsound.h)

Vedere anche

IKsPropertySet::Set

Condividi tramite