IOCTL_KS_PROPERTY IOCTL (ks.h)
Un'applicazione può usare IOCTL_KS_PROPERTY per ottenere o impostare proprietà oppure per determinare le proprietà supportate da un oggetto KS. L'applicazione passa IOCTL_KS_PROPERTY con i parametri descritti di seguito alla funzione KsSynchronousDeviceControl .
Codice principale
Buffer di input
Il contenuto del parametro InBuffer specificato dal client dipende dalla richiesta di proprietà e viene documentato per ogni set di proprietà. Ad esempio, i client che richiedono proprietà nel set di proprietà KSPROPSETID_Pin specificano un puntatore a una struttura KSP_PIN .
Lunghezza del buffer di input
L'applicazione inserisce le dimensioni, in byte, del contenuto del buffer di input nel parametro InLength .
Buffer di output
Analogamente, il tipo di buffer di output richiesto dipende anche dalla richiesta di proprietà.
Lunghezza del buffer di output
L'applicazione inserisce le dimensioni, in byte, del buffer di output nel parametro OutLength .
Blocco dello stato
Se la richiesta ha esito positivo, il membro Status è impostato su STATUS_SUCCESS.
Commenti
Per altre informazioni sui buffer di input e di output e sulle relative dimensioni, vedere Proprietà KS.
Filtri e pin supportano i set di proprietà usando il controllo I/O del dispositivo IOCTL_KS_PROPERTY . Sebbene questo IOCTL sia definito con il flag METHOD_NEITHER, i dati della proprietà vengono passati come buffer di output all'IOCTL e probe per l'accesso in lettura. La funzione KsPropertyHandler gestisce le proprietà richieste tramite IOCTL_KS_PROPERTY.
Per un elenco di flag validi e descrizioni corrispondenti, vedere la pagina di riferimento per la struttura KSPROPERTY .
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ks.h (include Ks.h) |