IOCTL_KS_PROPERTY IOCTL (ks.h)

Artículo
02/29/2024

Una aplicación puede usar IOCTL_KS_PROPERTY para obtener o establecer propiedades, o para determinar las propiedades admitidas por un objeto KS. La aplicación pasa IOCTL_KS_PROPERTY con los parámetros descritos a continuación a la función KsSynchronousDeviceControl .

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El contenido del parámetro InBuffer especificado por el cliente depende de la solicitud de propiedad y se documenta para cada conjunto de propiedades. Por ejemplo, los clientes que solicitan propiedades en el conjunto de propiedades KSPROPSETID_Pin especifican un puntero a una estructura de KSP_PIN .

Longitud del búfer de entrada

La aplicación coloca el tamaño, en bytes, del contenido del búfer de entrada en el parámetro InLength .

Búfer de salida

Del mismo modo, el tipo de búfer de salida necesario también depende de la solicitud de propiedad.

Longitud del búfer de salida

La aplicación coloca el tamaño, en bytes, del búfer de salida en el parámetro OutLength .

Bloque de estado

Si la solicitud se realiza correctamente, el miembro Status se establece en STATUS_SUCCESS.

Comentarios

Para obtener más información sobre los búferes de entrada y salida y sus tamaños, vea Propiedades de KS.

Los filtros y patillas admiten conjuntos de propiedades mediante el control de E/S del dispositivo IOCTL_KS_PROPERTY . Aunque este IOCTL se define con la marca METHOD_NEITHER, los datos de propiedad se pasan como el búfer de salida al IOCTL y se sondean para el acceso de lectura. La función KsPropertyHandler controla las propiedades solicitadas a través de IOCTL_KS_PROPERTY.

Para obtener una lista de marcas válidas y descripciones correspondientes, consulte la página de referencia de la estructura KSPROPERTY .