FSCTL_OPLOCK_BREAK_ACK_NO_2 código de controle
O código de controle FSCTL_OPLOCK_BREAK_ACK_NO_2 responde à notificação de que um bloqueio oportunista exclusivo (nível 1, lote ou filtro) em um arquivo foi quebrado.
Um aplicativo cliente envia esse código de controle para indicar que reconhece a quebra de oplock e que, se o oplock for um oplock de nível 1 que foi quebrado no nível 2, ele não deseja o nível 2 oplock.
Para processar esse código de controle, um minifiltro chama FltOplockFsctrl com os parâmetros a seguir. Um sistema de arquivos ou driver de filtro herdado chama FsRtlOplockFsctrl.
Para obter mais informações sobre bloqueio oportunista e sobre o código de controle FSCTL_OPLOCK_BREAK_ACK_NO_2, consulte a documentação do SDK do Microsoft Windows.
Parâmetros
Oplock: ponteiro de objeto oplock oplock para o arquivo.
CallbackData: somente FltOplockFsctrl . Estrutura de dados de retorno de chamada (FLT_CALLBACK_DATA) para uma solicitação FSCTL IRP_MJ_FILE_SYSTEM_CONTROL. O parâmetro FsControlCode para a operação deve ser FSCTL_OPLOCK_BREAK_ACK_NO_2.
Irp: somente FsRtlOplockFsctrl . IRP para uma solicitação FSCTL IRP_MJ_FILE_SYSTEM_CONTROL. O parâmetro FsControlCode para a operação deve ser FSCTL_OPLOCK_BREAK_ACK_NO_2.
OpenCount: não usado com esta operação; definido como zero.
Bloco de status
FltOplockFsctrl sempre retorna FLT_PREOP_COMPLETE para essa operação.
FsRtlOplockFsctrl retorna um dos seguintes valores NTSTATUS para esta operação:
| Código | Significado |
|---|---|
| STATUS_SUCCESS | A quebra do oplock é reconhecida. Nenhum oplock restante é mantido. |
| STATUS_INVALID_OPLOCK_PROTOCOL | Nenhum oplock foi mantido por esse identificador ou a quebra de oplock não está em andamento no momento. Este é um código de erro. |
Requisitos
| Tipo de Requisito | Requisito |
|---|---|
| parâmetro | Ntifs.h (inclua Ntifs.h ou Fltkernel.h) |
Confira também
FLT_PARAMETERS para IRP_MJ_FILE_SYSTEM_CONTROL
FSCTL_OPBATCH_ACK_CLOSE_PENDING