Compartilhar via


NDK_FN_INVALIDATE função de retorno de chamada (ndkpi.h)

A função NdkInvalidate (NDK_FN_INVALIDATE) Invalida uma MR (região de memória NDK) de registro rápido ou uma janela de memória (MW).

Sintaxe

NDK_FN_INVALIDATE NdkFnInvalidate;

NTSTATUS NdkFnInvalidate(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_OBJECT_HEADER *pNdkMrOrMw,
  [in]           ULONG Flags
)
{...}

Parâmetros

[in] pNdkQp

Um ponteiro para um objeto de QP (par de filas) NDK (NDK_QP).

[in, optional] RequestContext

Um valor de contexto a ser retornado no membro RequestContext da estrutura NDK_RESULT para essa solicitação.

[in] pNdkMrOrMw

Um ponteiro para um objeto mr (região de memória) (NDK_MR) ou um objeto de memória (MW) (NDK_MW) especificado em uma estrutura NDK_OBJECT_HEADER . Se um objeto MR for especificado, o objeto MR deverá ter sido registrado com a função NdkFastRegister (NDK_FN_FAST_REGISTER). O consumidor do NDK nunca deve especificar um objeto MR registrado com a função NdkRegister (NDK_FN_REGISTER) no parâmetro pNdkMrOrMw . O acesso a objetos MR registrados com a função NdkRegister (NDK_FN_REGISTER)) pode ser removido com a função NdkDeregisterMr (NDK_FN_DEREGISTER_MR).

[in] Flags

Um OR bit a bit de sinalizadores que especifica as operações permitidas. Há suporte para os seguintes sinalizadores:

Valor Significado
NDK_OP_FLAG_SILENT_SUCCESS
0x00000001
Indica que a conclusão bem-sucedida dessa solicitação não gera um evento de conclusão na fila de conclusão de saída. No entanto, as solicitações que falham geram um evento na fila de conclusão.
NDK_OP_FLAG_READ_FENCE
0x00000002
Indica que todas as solicitações de leitura anteriores devem ser concluídas antes que o hardware comece a processar essa solicitação.
NDK_OP_FLAG_DEFER
0x00000200
Indica ao provedor NDK que ele pode adiar indicando a solicitação de hardware para processamento. Para obter mais informações sobre esse sinalizador, consulte Esquema de processamento adiado do NDKPI.

Nota Esse sinalizador tem suporte apenas no NDKPI 1.2 (Windows Server 2012 R2) e posterior.

Retornar valor

O
A função NdkInvalidate retorna um dos seguintes códigos NTSTATUS.

Código de retorno Descrição
STATUS_SUCCESS
A solicitação foi postada com êxito. Uma entrada de conclusão será enfileirada no CQ quando a solicitação de trabalho for concluída.
STATUS_CONNECTION_INVALID
O QP não está conectado.
Outros códigos de status
Ocorreu um erro.

Comentários

NdkInvalidate invalida um MR ou MW de registro rápido do NDK.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum com suporte, com suporte no NDIS 6.30 e posterior.
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho ndkpi.h (inclua Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Confira também

Requisitos de tratamento de conclusão do NDKPI

Esquema de processamento adiado do NDKPI

Requisitos de postagem de solicitação de trabalho do NDKPI

NDK_FN_DEREGISTER_MR

NDK_FN_FAST_REGISTER

NDK_FN_REGISTER

NDK_MR

NDK_MW

NDK_OBJECT_HEADER

NDK_QP

NDK_RESULT