Metodo IKsPropertySet::Get (ksproxy.h)

Articolo
08/07/2023

Il metodo Get recupera una proprietà identificata da un GUID set di proprietà e 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 a dati di 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 PropertyData.

[out] BytesReturned

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

Valore restituito

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

Commenti

Per recuperare una proprietà, allocare un buffer, che ottiene riempimenti 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.

Avviso

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, tuttavia il file di intestazione analizza prima è quello la cui definizione di IKsPropertySet viene usata dal compilatore.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	ksproxy.h (includono Ksproxy.h, Dsound.h)

Vedi anche

IKsPropertySet::Set

Condividi tramite