Função FltGetNewSystemBufferAddress (fltkernel.h)
A função FltGetNewSystemBufferAddress recupera o buffer AssociatedIrp.SystemBuffer, que o sistema de arquivos alocou. A rotina pós-retorno de chamada de um driver de minifiltro chama essa função.
Sintaxe
PVOID FLTAPI FltGetNewSystemBufferAddress(
[in] PFLT_CALLBACK_DATA CallbackData
);
Parâmetros
[in] CallbackData
Um ponteiro para uma estrutura de FLT_CALLBACK_DATA que representa uma operação de E/S.
Valor de retorno
Se o buffer AssociatedIrp.SystemBuffer tiver sido alocado pelo sistema de arquivos, FltGetNewSystemBufferAddress retornará um ponteiro para esse buffer; caso contrário, retornará NULL.
Observações
A rotina pós-retorno de chamada de um driver de minifiltro chama função fltGetNewSystemBufferAddress para recuperar um ponteiro para o buffer AssociatedIrp.SystemBuffer alocado pelo sistema de arquivos. Um driver de minifiltro deve chamar essa função somente quando o sinalizador de FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER for definido em CallbackData.Flags.
Quando o sistema de arquivos aloca seu próprio buffer AssociatedIrp.SystemBuffer, o Gerenciador de Filtros definirá o sinalizador FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER. Isso sinaliza ao minifiltro que o buffer recebido na pré-operação não é aquele que tem os dados lidos do sistema de arquivos.
Se o sinalizador FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER não estiver definido, essa rotina retornará NULL .
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows 7 e versões posteriores do sistema operacional Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | Fltmgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |