IKsControl::KsProperty-Methode (ksproxy.h)
Die KsProperty-Methode legt eine Eigenschaft fest oder ruft Eigenschafteninformationen zusammen mit allen anderen definierten Supportvorgängen ab, die für einen Eigenschaftensatz verfügbar sind.
Syntax
HRESULT KsProperty(
[in] PKSPROPERTY Property,
[in] ULONG PropertyLength,
[in, out] LPVOID PropertyData,
[in] ULONG DataLength,
[in, out] ULONG *BytesReturned
);
Parameter
[in] Property
Zeiger auf eine Struktur, die eine Eigenschaft und den Anforderungstyp der Eigenschaftenanforderung beschreibt. Diese Struktur muss entweder eine KSPROPERTY-Struktur oder eine Struktur sein, die eine KSPROPERTY-Struktur als erstes Element enthält. Ein Beispiel für eine Struktur, auf die von diesem Member verwiesen werden kann, ist die KSPROPERTY_VIDEOPROCAMP_S-Struktur .
[in] PropertyLength
Größe des Puffers in Byte unter Property.
[in, out] PropertyData
Zeiger auf einen Puffer, der Daten für einen KSPROPERTY_TYPE_SET-, KSPROPERTY_TYPE_UNSERIALIZESET- oder KSPROPERTY_TYPE_UNSERIALIZERAW-Vorgang oder Pufferspeicher enthält, der Daten für alle anderen Vorgänge empfängt.
[in] DataLength
Größe des Puffers in Byte unter PropertyData.
[in, out] BytesReturned
Zeiger auf eine Variable, die die Größe der Daten in Bytes empfängt, die KsProperty im Puffer unter PropertyData speichert. Wenn keine Daten gespeichert werden, ist die Größe null.
Rückgabewert
Gibt NOERROR zurück, wenn dies erfolgreich war. Gibt andernfalls einen Fehlercode zurück.
Hinweise
Um die Puffergröße zu bestimmen, die für eine bestimmte Eigenschaftsanforderung erforderlich ist, können Sie diese Methode aufrufen, wobei PropertyData auf NULL und DataLength gleich 0 festgelegt ist. Die -Methode gibt HRESULT_FROM_WIN32(ERROR_MORE_DATA) zurück, und BytesReturned enthält die Größe des erforderlichen Puffers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | DesktopMobile |
| Kopfzeile | ksproxy.h (include Ksproxy.h) |