CODECAPI_ALLSETTINGS
A propriedade CODECAPI_ALLSETTINGS é usada para passar um bloco de dados gerado por minidriver.
| Obter | Definir | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
| Sim | Sim | Filtrar | KSPROPERTY | PVOID |
O valor da propriedade (dados de operação) é do tipo PVOID, que é um ponteiro para um buffer de modo de usuário para o bloco de dados gerado pelo minidriver.
Comentários
Em uma chamada de obtenção de propriedade:
Se um aplicativo fizer uma chamada de obtenção de propriedade com um buffer de comprimento zero, o minidriver deverá retornar STATUS_BUFFER_OVERFLOW e especificar o tamanho do buffer necessário no campo Irp-IoStatus.Information>. Se o buffer de comprimento for diferente de zero, o minidriver deverá retornar STATUS_BUFFER_TOO_SMALL se o buffer fornecido for muito pequeno para o bloco de dados, caso contrário, o minidriver empacota suas configurações em um bloco de dados que pode ser restaurado posteriormente.
É responsabilidade do minidriver adicionar verificações de integridade de dados aos dados, como um GUID exclusivo para indicar que o minidriver gerou os dados, um CRC (marcar de redundância cíclica) e um comprimento de cabeçalho.
Os dados retornados devem ser leves e conter apenas as informações necessárias para reconstruir as configurações atuais.
Os aplicativos usarão essa propriedade para undos de vários níveis, armazenados com seus projetos e assim por diante.
Em uma chamada de conjunto de propriedades:
O minidriver deve verificar a integridade dos dados e marcar se o tamanho do bloco de dados está abaixo do tamanho máximo dos dados (por exemplo, rejeitar qualquer coisa em um determinado tamanho). Ele também deve verificar o CRC e o comprimento do cabeçalho. O minidriver também deve armazenar em cache as alterações a serem propagadas para CODECAPI_CURRENTCHANGELIST.
Requisitos
Cabeçalhos: Declarado em ksmedia.h. Inclua ksmedia.h.