Metodo IKsPropertySet::Get (dsound.h)

Articolo
02/06/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 rguidPropSet,
  [in]  ULONG   ulId,
  [in]  LPVOID  pInstanceData,
  [in]  ULONG   ulInstanceLength,
  [out] LPVOID  pPropertyData,
  [in]  ULONG   ulDataLength,
  [out] PULONG  pulBytesReturned
);

Parametri

[in] rguidPropSet

GUID che identifica il set di proprietà.

[in] ulId

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

[in] pInstanceData

Puntatore ai dati dell'istanza per la proprietà .

[in] ulInstanceLength

Dimensioni, in byte, del buffer in InstanceData.

[out] pPropertyData

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

[in] ulDataLength

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

[out] pulBytesReturned

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. La versione DirectSound di IKsPropertySet è descritta nelle pagine di riferimento DirectSound nella documentazione di Microsoft Windows SDK. 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	dsound.h (include Ksproxy.h, Dsound.h)

Vedere anche

IKsPropertySet::Set

Condividi tramite