IOCTL_KS_PROPERTY IOCTL (ks.h)
Um aplicativo pode usar IOCTL_KS_PROPERTY para obter ou definir propriedades ou 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
Buffer de entrada
O conteúdo do parâmetro InBuffer especificado pelo cliente dependem da solicitação de propriedade e estão documentados 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.
Observações
Para obter mais informações sobre buffers de entrada e saída e seus tamanhos, consulte propriedades 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 de KSPROPERTY.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ks.h (incluir Ks.h) |