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

Artigo
02/07/2025

A função NdkCreateMr (NDK_FN_CREATE_MR) cria um objeto mr (região de memória NDK).

Sintaxe

NDK_FN_CREATE_MR NdkFnCreateMr;

NTSTATUS NdkFnCreateMr(
  [in]           NDK_PD *pNdkPd,
  [in]           BOOLEAN FastRegister,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_MR **ppNdkMr
)
{...}

Parâmetros

[in] pNdkPd

Um ponteiro para um objeto PD (domínio de proteção NDK) (NDK_PD).

[in] FastRegister

Se TRUE, o MR será somente para registro rápido. Caso contrário, o MR destina-se apenas ao registro normal.

[in] CreateCompletion

Um ponteiro para uma função NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) que conclui a criação de um objeto NDK.

[in, optional] RequestContext

Um valor de contexto que o provedor NDK passa de volta para a função NdkCreateCompletion especificada no parâmetro CreateCompletion.

ppNdkMr

Um ponteiro para o objeto MR criado (NDK_MR) será retornado nesse local se a solicitação for bem-sucedida sem retornar STATUS_PENDING. Se NdkCreateMr retornar STATUS_PENDING, esse parâmetro será ignorado e o objeto criado será retornado com o retorno de chamada especificado no parâmetro CreateCompletion.

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	O objeto MR foi criado com êxito e retornado com o parâmetro *ppNdkMr.
STATUS_PENDING	A operação está pendente e será concluída posteriormente. O provedor chamará a função especificada no parâmetro CreateCompletion(NDK_FN_CREATE_COMPLETION) para concluir a operação pendente.
STATUS_INSUFFICIENT_RESOURCES	A solicitação falhou devido a recursos insuficientes. Importante A solicitação pode falhar embutida, bem como de forma assíncrona com esse código de status.
Outros códigos de status	Ocorreu um erro.

Observações

A função NdkCreateMr cria um objeto mr (região de memória NDK) que pode ser usado para registro de memória e solicitações de registro rápido. Se a função retornar STATUS_SUCCESS, o objeto criado será retornado no parâmetro ppNdkMr. Se NdkCreateMr retornar STATUS_PENDING, o objeto criado será retornado pela função NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) especificada no parâmetro CreateCompletion.

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

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD

Compartilhar via