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 |
|---|---|
|
A inicialização foi concluída com êxito. |
|
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. |
|
A solicitação falhou porque o adaptador não dá suporte ao AdapterPageCount solicitado. |
|
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 |