IKsPropertySet::Get-Methode (ksproxy.h)
Die Get-Methode ruft eine Eigenschaft ab, die durch eine Eigenschaftensatz-GUID und einen Eigenschaftenbezeichner 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 instance Daten für die Eigenschaft.
[in] InstanceLength
Größe des Puffers in Byte unter InstanceData.
[out] PropertyData
Zeiger auf einen Puffer, der den Wert der -Eigenschaft empfängt.
[in] DataLength
Größe des Puffers in Byte unter PropertyData.
[out] BytesReturned
Zeiger auf eine Variable, die die Größe der Daten in Bytes empfängt, die Get im Puffer unter PropertyData speichert.
Rückgabewert
Gibt NOERROR zurück, wenn dies erfolgreich war. Gibt andernfalls einen Fehlercode zurück.
Hinweise
Um eine Eigenschaft abzurufen, ordnen Sie einen Puffer zu, der get mit der -Eigenschaft auffüllt. Geben Sie null für PropertyData und null für DataLength an, um die erforderliche Puffergröße zu bestimmen. Die Get-Methode gibt die erforderliche Puffergröße in BytesReturned zurück.
Warnung
Headerdateien ksproxy.h und dsound.h definieren ähnliche, aber inkompatible Versionen der IKsPropertySet-Schnittstelle . Anwendungen, die das KS-Proxymodul erfordern, sollten die in ksproxy.h definierte Version verwenden. Wenn eine Anwendung sowohl ksproxy.h als auch dsound.h enthalten muss, ist die Headerdatei, die der Compiler zuerst überprüft, die Definition von IKsPropertySet vom Compiler verwendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ksproxy.h (include Ksproxy.h, Dsound.h) |