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 QP (par de filas NDK) (NDK_QP).
[in, optional] RequestContext
Um valor de contexto a ser retornado no requestContext membro 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 (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 |
---|---|
|
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. |
|
Indica que todas as solicitações de leitura anteriores devem ser concluídas antes que o hardware comece a processar essa solicitação. |
|
Indica ao provedor NDK que ele pode adiar a indicação da solicitação ao hardware para processamento. Para obter mais informações sobre esse sinalizador, consulte esquema de processamento adiado do NDKPI.
Observação Esse sinalizador tem suporte apenas no NDKPI 1.2 (Windows Server 2012 R2) e posterior. |
Valor de retorno
O
função NdkInvalidate retorna um dos seguintes códigos NTSTATUS.
Código de retorno | Descrição |
---|---|
|
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. |
|
O QP não está conectado. |
|
Ocorreu um erro. |
Observações
NdkInvalidate invalida um MR ou MW de registro rápido do NDK.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Nenhum com suporte, com suporte no NDIS 6.30 e posterior. |
servidor com suporte mínimo | Windows Server 2012 |
da Plataforma de Destino | Windows |
cabeçalho | ndkpi.h (inclua Ndkpi.h) |
IRQL | <=DISPATCH_LEVEL |
Consulte também
requisitos de tratamento de conclusão do NDKPI
esquema de processamento adiado do NDKPI