IKsPropertySet::Get-Methode (dsound.h)
Die Get-Methode ruft eine Eigenschaft ab, die durch eine Eigenschaftensatz-GUID und einen Eigenschaftsbezeichner identifiziert wird.
Syntax
HRESULT Get(
[in] REFGUID rguidPropSet,
[in] ULONG ulId,
[in] LPVOID pInstanceData,
[in] ULONG ulInstanceLength,
[out] LPVOID pPropertyData,
[in] ULONG ulDataLength,
[out] PULONG pulBytesReturned
);
Parameter
[in] rguidPropSet
GUID, die den Eigenschaftensatz identifiziert.
[in] ulId
Bezeichner der Eigenschaft innerhalb des Eigenschaftensatzes.
[in] pInstanceData
Zeiger auf Instanzdaten für die Eigenschaft.
[in] ulInstanceLength
Größe des Puffers in Bytes bei InstanceData-.
[out] pPropertyData
Zeiger auf einen Puffer, der den Wert der Eigenschaft empfängt.
[in] ulDataLength
Größe des Puffers in Bytes bei PropertyData-.
[out] pulBytesReturned
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. Die DirectSound-Version von IKsPropertySet- wird in den DirectSound-Referenzseiten in der Microsoft Windows SDK-Dokumentation beschrieben. 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- | dsound.h (include Ksproxy.h, Dsound.h) |