IOCTL_KS_PROPERTY IOCTL (ks.h)

Artigo
08/07/2023

Um aplicativo pode usar IOCTL_KS_PROPERTY para obter ou definir propriedades ou para determinar as propriedades compatíveis com um objeto KS. O aplicativo passa IOCTL_KS_PROPERTY com os parâmetros descritos abaixo para a função KsSynchronousDeviceControl .

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O conteúdo do parâmetro InBuffer especificado pelo cliente depende da solicitação de propriedade e está documentado para cada conjunto de propriedades. Por exemplo, os clientes que solicitam propriedades no conjunto de propriedades KSPROPSETID_Pin especificam um ponteiro para uma estrutura KSP_PIN .

Comprimento do buffer de entrada

O aplicativo coloca o tamanho, em bytes, do conteúdo do buffer de entrada no parâmetro InLength .

Buffer de saída

Da mesma forma, o tipo de buffer de saída necessário também depende da solicitação de propriedade.

Comprimento do buffer de saída

O aplicativo coloca o tamanho, em bytes, do buffer de saída no parâmetro OutLength .

Bloco de status

Se a solicitação for bem-sucedida, o membro Status será definido como STATUS_SUCCESS.

Comentários

Para obter mais informações sobre buffers de entrada e saída e seus tamanhos, consulte Propriedades do KS.

Filtros e pinos dão suporte a conjuntos de propriedades usando o controle de E/S do dispositivo IOCTL_KS_PROPERTY . Embora esse IOCTL seja definido com o sinalizador METHOD_NEITHER, os dados da propriedade são passados como o buffer de saída para o IOCTL e investigados para acesso de leitura. A função KsPropertyHandler manipula as propriedades solicitadas por meio de IOCTL_KS_PROPERTY.

Para obter uma lista de sinalizadores válidos e descrições correspondentes, consulte a página de referência da estrutura KSPROPERTY .