Função FsRtlOplockBreakH (ntifs.h)

O FsRtlOplockBreakH quebras de rotina 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 do arquivo associado. Um sistema de arquivos ou driver de filtro define bits para especificar o comportamento de FsRtlOplockBreakH. O parâmetro sinalizadores de 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 interrupção 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 do pacote oplock aguardar 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.

Valor de retorno

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 sucesso.
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 de opções de criação para a operação e há um oplock concedido. STATUS_CANNOT_BREAK_OPLOCK é um código de erro.

Observações

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 sinalizadores , FsRtlOplockBreakH interromperá 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.

Os minifiltros devem chamar FltOplockBreakH em vez de FsRtlOplockBreakH .

Requisitos

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

Consulte também

FltOplockBreakH

FsRtlInitializeOplock