IKsPropertySet::Get-Methode (ksproxy.h)

Artikel
02/07/2025

Die Get-Methode ruft eine Eigenschaft ab, die durch eine Eigenschaftensatz-GUID und einen Eigenschaftsbezeichner identifiziert wird.

Syntax

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

Parameter

[in] PropSet

GUID, die den Eigenschaftensatz identifiziert.

[in] Id

Bezeichner der Eigenschaft innerhalb des Eigenschaftensatzes.

[in] InstanceData

Zeiger auf Instanzdaten für die Eigenschaft.

[in] InstanceLength

Größe des Puffers in Bytes bei InstanceData-.

[out] PropertyData

Zeiger auf einen Puffer, der den Wert der Eigenschaft empfängt.

[in] DataLength

Größe des Puffers in Bytes bei PropertyData-.

[out] BytesReturned

Zeigen Sie auf eine Variable, die die Größe der Daten in Byte empfängt, die Abrufen im Puffer bei PropertyData-.

Rückgabewert

Gibt NOERROR zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben.

Bemerkungen

Um eine Eigenschaft abzurufen, weisen Sie einen Puffer zu, der Abrufen Füllungen mit der Eigenschaft. Um die erforderliche Puffergröße zu ermitteln, geben Sie NULL- für PropertyData- und Null für DataLength-an. Die Get-Methode gibt die erforderliche Puffergröße in BytesReturned-zurück.

Warnung

Headerdateien ksproxy.h und dsound.h ähnliche, aber inkompatible Versionen der IKsPropertySet Schnittstelle definieren. Anwendungen, die das KS-Proxymodul erfordern, sollten die in ksproxy.hdefinierte Version verwenden. Wenn eine Anwendung sowohl ksproxy.h als auch dsound.henthalten muss, ist die Headerdatei, die der Compiler zuerst scannt, die Definition von IKsPropertySet- vom Compiler verwendet wird.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	ksproxy.h (include Ksproxy.h, Dsound.h)

Siehe auch

IKsPropertySet::Set

Freigeben über