IKsPropertySet::Get-Methode (dsound.h)
Die Get-Methode ruft eine Eigenschaft ab, die durch eine Eigenschaftensatz-GUID und einen Eigenschaftenbezeichner 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 instance Daten für die Eigenschaft.
[in] ulInstanceLength
Größe des Puffers in Byte unter InstanceData.
[out] pPropertyData
Zeiger auf einen Puffer, der den Wert der -Eigenschaft empfängt.
[in] ulDataLength
Größe des Puffers in Byte unter PropertyData.
[out] pulBytesReturned
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. Die DirectSound-Version von IKsPropertySet wird auf den DirectSound-Referenzseiten in der Microsoft Windows SDK-Dokumentation beschrieben. 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 | dsound.h (include Ksproxy.h, Dsound.h) |