Metodo IKsPropertySet::Get (dsound.h)

Articolo
02/29/2024

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

[out] pulBytesReturned

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. 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, 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	dsound.h (include Ksproxy.h, Dsound.h)

Vedi anche

IKsPropertySet::Set

Condividi tramite