Condividi tramite


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

IRP_MJ_DEVICE_CONTROL

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 di stato

Se la richiesta ha esito positivo, il membro Status viene impostato su STATUS_SUCCESS.

Osservazioni

Per altre informazioni sui buffer di input e output e sulle relative dimensioni, vedere proprietà KS.

I filtri e i pin supportano i set di proprietà usando il controllo I/O del dispositivo IOCTL_KS_PROPERTY. Anche se questo IOCTL viene definito con il flag METHOD_NEITHER, i dati della proprietà vengono passati come buffer di output a IOCTL e a cui viene eseguito il 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.

Fabbisogno

Requisito Valore
intestazione ks.h (include Ks.h)

Vedere anche

KSPROPERTY

KSPROPERTY_DESCRIPTION

KSPROPERTY_ITEM

KSPROPERTY_MEMBERSHEADER

KSPROPERTY_SET

KSPROPERTY_VALUES