Função KsPropertyHandlerWithAllocator (ks.h)
O KsPropertyHandlerWithAllocator executa o mesmo tratamento que KsPropertyHandler, com as mesmas restrições, mas permite que um retorno de chamada do alocador opcional seja usado para fornecer um buffer para os parâmetros. Se usado, o filtro pode precisar liberar o buffer de alguma maneira não condicional. IRP_BUFFERED_IO e sinalizadores de IRP_DEALLOCATE_BUFFER não são definidos ao usar um alocador personalizado.
Sintaxe
KSDDKAPI NTSTATUS KsPropertyHandlerWithAllocator(
[in] PIRP Irp,
[in] ULONG PropertySetsCount,
[in] const KSPROPERTY_SET *PropertySet,
[in, optional] PFNKSALLOCATOR Allocator,
[in, optional] ULONG PropertyItemSize
);
Parâmetros
[in] Irp
Especifica o IRP com a solicitação de propriedade sendo tratada.
[in] PropertySetsCount
Especifica o número de conjuntos de propriedades que estão sendo passados.
[in] PropertySet
Especifica o ponteiro para uma matriz de informações do conjunto de propriedades.
[in, optional] Allocator
Opcionalmente, aponta para uma função de alocação usada para alocar memória para armazenar os parâmetros de propriedade.
[in, optional] PropertyItemSize
Opcionalmente, contém o tamanho de cada estrutura KSPROPERTY_ITEM nas propriedades. O item de propriedade pode ser estendido para armazenar informações privadas. Se esse parâmetro for zero, o tamanho da estrutura será considerado normal. Se for maior ou igual a uma estrutura de item de propriedade, a macro KSPROPERTY_ITEM_IRP_STORAGE poderá ser usada para retornar um ponteiro para o item de propriedade para que os dados personalizados possam ser recuperados. Em plataformas de 64 bits, esse parâmetro deve ser um múltiplo de 8.
Retornar valor
A função KsPropertyHandler retornará STATUS_SUCCESS se tiver êxito ou um erro específico para a propriedade que está sendo tratada se não tiver êxito. A função define o membro Irp-IoStatus.Information, definindo-o> como zero devido a um erro interno ou por meio de um manipulador de propriedades definindo-o. A função não define o membro lrp-IoStatus.Status> nem conclui o IRP.
Em plataformas de 64 bits, se o parâmetro PropertyItemSize não for um múltiplo de 8, STATUS_INVALID_PARAMETER será retornado e a chamada falhará.
Comentários
KsPropertyHandlerWithAllocator coloca um ponteiro para a estrutura de KSPROPERTY_ITEM relevante no parâmetro Irp-Tail.Overlay.DriverContext> no IRP. O minidriver pode usar a macro KSPROPERTY_ITEM_IRP_STORAGE, definida em ks.h, para acessar esse ponteiro.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |