IOCTL_KS_PROPERTY IOCTL (ks.h)
Eine Anwendung kann IOCTL_KS_PROPERTY verwenden, um Eigenschaften abzurufen oder festzulegen oder um die von einem KS-Objekt unterstützten Eigenschaften zu bestimmen. Die Anwendung übergibt IOCTL_KS_PROPERTY mit den unten beschriebenen Parametern an die KsSynchronousDeviceControl-Funktion .
Hauptcode
Eingabepuffer
Der Inhalt des vom Client angegebenen InBuffer-Parameters hängt von der Eigenschaftenanforderung ab und wird für jeden Eigenschaftensatz dokumentiert. Für instance geben Clients, die Eigenschaften im KSPROPSETID_Pin Eigenschaftensatz anfordern, einen Zeiger auf eine KSP_PIN-Struktur an.
Länge des Eingabepuffers
Die Anwendung platziert die Größe des Eingabepufferinhalts in Bytes im InLength-Parameter .
Ausgabepuffer
Auf ähnliche Weise hängt der Typ des erforderlichen Ausgabepuffers auch von der Eigenschaftenanforderung ab.
Länge des Ausgabepuffers
Die Anwendung platziert die Größe des Ausgabepuffers in Bytes im OutLength-Parameter .
Statusblock
Wenn die Anforderung erfolgreich ist, wird der Status-Member auf STATUS_SUCCESS festgelegt.
Hinweise
Weitere Informationen zu Eingabe- und Ausgabepuffern und deren Größen finden Sie unter KS-Eigenschaften.
Filter und Pins unterstützen Eigenschaftensätze mithilfe des IOCTL_KS_PROPERTY Geräte-E/A-Steuerelements. Obwohl diese IOCTL mit dem METHOD_NEITHER-Flag definiert ist, werden die Eigenschaftsdaten als Ausgabepuffer an die IOCTL übergeben und auf Lesezugriff überprüft. Die KsPropertyHandler-Funktion verarbeitet eigenschaften, die über IOCTL_KS_PROPERTY angefordert werden.
Eine Liste der gültigen Flags und entsprechenden Beschreibungen finden Sie auf der Referenzseite für die KSPROPERTY-Struktur .
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ks.h (ks.h einschließen) |