IKsControl::KsProperty-Methode (ks.h)
Die IKsControl::KsProperty-Methode legt eine Eigenschaft fest oder ruft Eigenschafteninformationen zusammen mit allen anderen definierten Unterstützungsvorgängen ab, die für einen Eigenschaftensatz verfügbar sind.
Syntax
NTSTATUS KsProperty(
[in] PKSPROPERTY Property,
[in] ULONG PropertyLength,
[in, out] PVOID PropertyData,
[in] ULONG DataLength,
[out] ULONG *BytesReturned
);
Parameter
[in] Property
Zeiger auf eine Struktur, die eine Eigenschaft und den Anforderungstyp der Eigenschaftsanforderung 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
Gibt die Größe des Puffers unter Eigenschaft in Bytes an.
[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
Gibt die Größe des Puffers bei PropertyData in Bytes an.
[out] BytesReturned
Zeiger auf eine Variable, die die Größe der Daten empfängt, die KsProperty im Puffer unter PropertyData speichert. Wenn keine Daten gespeichert werden, ist die Größe 0.
Rückgabewert
Die IKsControl::KsProperty-Methode gibt denselben Wert zurück, der zurückgegeben würde, wenn die Eigenschaft von IOCTL gesendet worden wäre.
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 | ks.h (einschließlich Ks.h) |