Função FsRtlOplockBreakH (ntifs.h)

A rotina FsRtlOplockBreakH quebra CACHE_HANDLE_LEVEL bloqueios oportunistas (oplocks).

Sintaxe

NTSTATUS FsRtlOplockBreakH(
  [in]           POPLOCK                       Oplock,
  [in]           PIRP                          Irp,
  [in]           ULONG                         Flags,
  [in, optional] PVOID                         Context,
  [in, optional] POPLOCK_WAIT_COMPLETE_ROUTINE CompletionRoutine,
  [in, optional] POPLOCK_FS_PREPOST_IRP        PostIrpRoutine
);

Parâmetros

[in] Oplock

Um ponteiro de bloqueio oportunista opaco para o arquivo. Esse ponteiro deve ter sido inicializado por uma chamada anterior para FsRtlInitializeOplock.

[in] Irp

Um ponteiro para o IRP para a operação de E/S.

[in] Flags

Uma máscara de bits para a operação de E/S de arquivo associada. Um sistema de arquivos ou driver de filtro define bits para especificar o comportamento de FsRtlOplockBreakH. O parâmetro Flags tem as seguintes opções:

OPLOCK_FLAG_COMPLETE_IF_OPLOCKED (0x00000001)

Especifica para permitir que uma quebra de oplock prossiga sem bloquear ou aguardar a operação que causou a interrupção do oplock.

OPLOCK_FLAG_IGNORE_OPLOCK_KEYS (0x00000008)

Com suporte no Windows 7 e versões posteriores.

Especifica para permitir que CACHE_HANDLE_LEVEL quebras de oplock prossiga, independentemente da chave oplock.

[in, optional] Context

Um ponteiro para informações de contexto definidas pelo chamador a serem passadas para as rotinas de retorno de chamada para as quais os parâmetros CompletionRoutine e PostIrpRoutine apontam.

[in, optional] CompletionRoutine

Um ponteiro para uma rotina de retorno de chamada fornecida pelo chamador. Se uma quebra de oplock estiver em andamento, essa rotina será chamada quando a interrupção for concluída. Esse parâmetro é opcional e pode ser NULL. Se for NULL, o chamador será colocado em um estado de espera até que a quebra do oplock seja concluída.

Essa rotina é declarada da seguinte maneira:

typedef VOID
(*POPLOCK_WAIT_COMPLETE_ROUTINE) (
      IN PVOID Context,
      IN PIRP Irp
      );

Essa rotina tem os seguintes parâmetros:

Contexto

Um ponteiro de informações de contexto que foi passado no parâmetro Context para FsRtlOplockBreakH.

Irp

Um ponteiro para o IRP para a operação de E/S.

[in, optional] PostIrpRoutine

Um ponteiro para uma rotina de retorno de chamada fornecida pelo chamador a ser chamada se a operação de E/S estiver pendente. A rotina é chamada antes que o pacote oplock penda o IRP. Esse parâmetro é opcional e pode ser NULL.

Essa rotina é declarada da seguinte maneira:

typedef VOID
(*POPLOCK_FS_PREPOST_IRP) (
      IN PVOID Context,
      IN PIRP Irp
      );

Contexto

Um ponteiro de informações de contexto que foi passado no parâmetro Context para FsRtlOplockBreakH.

Irp

Um ponteiro para o IRP para a operação de E/S.

Retornar valor

FsRtlOplockBreakH retorna STATUS_SUCCESS ou um código NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_CANCELLED	O IRP foi cancelado. STATUS_CANCELLED é um código de erro.
STATUS_PENDING	O IRP foi postado em uma fila de trabalho. STATUS_PENDING é um código de êxito.
STATUS_CANNOT_BREAK_OPLOCK	A quebra de bloqueio oportunista (oplock) não pode ser realizada. O IRP é uma solicitação IRP_MJ_CREATE. FILE_OPEN_REQUIRING_OPLOCK foi especificado no parâmetro criar opções para a operação e há um oplock concedido. STATUS_CANNOT_BREAK_OPLOCK é um código de erro.

Comentários

Quando uma operação deve interromper CACHE_HANDLE_LEVEL oplocks, a operação chama FsRtlOplockBreakH.

Se o chamador especificar o sinalizador OPLOCK_FLAG_IGNORE_OPLOCK_KEYS no parâmetro Flags , FsRtlOplockBreakH quebrará todos os oplocks CACHE_HANDLE_LEVEL, independentemente da chave oplock. O comportamento padrão de FsRtlOplockBreakH é interromper oplocks cujas chaves não correspondem à chave no objeto de arquivo do chamador.

Minifilters devem chamar FltOplockBreakH em vez de FsRtlOplockBreakH.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	A rotina FsRtlOplockBreakH está disponível a partir do Windows 7.
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Confira também

FltOplockBreakH

FsRtlInitializeOplock