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)

Weitere Informationen

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S