IKsControl::KsProperty-Methode (ks.h)
Die IKsControl::KsProperty--Methode legt eine Eigenschaft fest oder ruft Eigenschafteninformationen zusammen mit anderen definierten Supportvorgä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
Zeigen Sie auf eine Struktur, die eine Eigenschaft und den Anforderungstyp der Eigenschaftsanforderung beschreibt. Diese Struktur muss entweder ein KSPROPERTY- oder eine Struktur sein, die eine KSPROPERTY- Struktur als erstes Element enthält. Ein Beispiel für eine Struktur, auf die dieses Element verweisen kann, ist die KSPROPERTY_VIDEOPROCAMP_S Struktur.
[in] PropertyLength
Gibt die Größe des Puffers in Bytes bei Propertyan.
[in, out] PropertyData
Zeigen Sie auf einen Puffer, der Daten für einen KSPROPERTY_TYPE_SET- oder KSPROPERTY_TYPE_UNSERIALIZESET- oder KSPROPERTY_TYPE_UNSERIALIZERAW-Vorgang oder Pufferbereich enthält, der Daten für alle anderen Vorgänge empfängt.
[in] DataLength
Gibt die Größe des Puffers in Bytes bei PropertyData-an.
[out] BytesReturned
Zeiger auf eine Variable, die die Größe der Daten in Byte empfängt, die KsProperty im Puffer bei PropertyData-speichert. Wenn keine Daten gespeichert werden, ist die Größe null.
Rückgabewert
Die IKsControl::KsProperty--Methode gibt denselben Wert zurück, der zurückgegeben wird, wenn die Eigenschaft von IOCTL gesendet wurde.
Bemerkungen
Um die Puffergröße zu ermitteln, die für eine bestimmte Eigenschaftsanforderung erforderlich ist, können Sie diese Methode aufrufen, wobei PropertyData- auf NULL- und DataLength- gleich Null festgelegt ist. Die Methode gibt HRESULT_FROM_WIN32(ERROR_MORE_DATA) zurück, und BytesReturned die Größe des erforderlichen Puffers enthält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | DesktopMobile |
| Header- | ks.h (enthalten Ks.h) |