IOCTL_KS_PROPERTY IOCTL (ks.h)
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
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 .
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ks.h (inclua Ks.h) |