IOCTL_KS_PROPERTY IOCTL (ks.h)

Artikel
02/26/2024

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

IRP_MJ_DEVICE_CONTROL

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 .