Compartilhar via


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

A função NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) inicializa uma MR (região de memória NDK) para registro rápido.

Sintaxe

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parâmetros

[in] pNdkMr

Um ponteiro para um objeto MR (região de memória NDK) (NDK_MR).

[in] AdapterPageCount

O número máximo de páginas do adaptador para dar suporte neste MR, de modo que solicitações de trabalho de registro rápido com igual ou um número menor de páginas de adaptador possam ter suporte.

[in] RemoteAccess

Um valor BOOLEAN que indica se o MR deve ser inicializado para acesso remoto ou não. Um consumidor do NDK deve definir RemoteAccess como TRUE se o consumidor solicitar acesso remoto com a função NdkFastRegister (NDK_FN_FAST_REGISTER).

[in] RequestCompletion

Um ponteiro para uma rotina de retorno de chamada de conclusão de solicitação NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Um valor de contexto a ser passado para o parâmetro Context da função de retorno de chamada especificada no parâmetro RequestCompletion .

Retornar valor

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

Código de retorno Descrição
STATUS_SUCCESS
A inicialização foi concluída com êxito.
STATUS_PENDING
A operação está pendente e será concluída posteriormente. O driver chamará a função RequestCompletion (NDK_FN_REQUEST_COMPLETION) especificada para concluir a operação pendente.
STATUS_IMPLEMENTATION_LIMIT
A solicitação falhou porque o adaptador não dá suporte ao AdapterPageCount solicitado.
Outros códigos status
Ocorreu um erro.

Comentários

NdkInitializeFastRegisterMr inicializa um MR para registro rápido. O objeto NDK_MR deve ser criado com o parâmetro FastRegister da função NdkCreateMr (NDK_FN_CREATE_MR) definida como TRUE.

Você pode fazer várias chamadas para NdkInitializeFastRegisterMr, em paralelo ou uma após a outra.

Depois que NdkInitializeFastRegisterMr retornar, uma solicitação de trabalho de registro rápido pode ser postada em um par de filas (QP).

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 tempo de vida do objeto NDKPI

NDK_FN_CREATE_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR