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

  • Artigo

A função NdkWrite (NDK_FN_WRITE) posta uma solicitação de gravação em um QP (par de filas NDK).

Sintaxe

NDK_FN_WRITE NdkFnWrite;

NTSTATUS NdkFnWrite(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
                 const NDK_SGE *pSgl,
  [in]           ULONG nSge,
  [in]           UINT64 RemoteAddress,
  [in]           UINT32 RemoteToken,
  [in]           ULONG Flags
)
{...}

Parâmetros

[in] pNdkQp

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

[in, optional] RequestContext

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

pSgl

Uma matriz de estruturas SGE (NDK_SGE) que representam os buffers que contêm os dados a serem gravados.

[in] nSge

O número de estruturas SGE na matriz especificada no parâmetro pSgl .

[in] RemoteAddress

O endereço remoto no qual gravar, fornecido na ordem de bytes do host local. O consumidor do NDK pode ter adicionado um deslocamento ao valor fornecido remotamente.

[in] RemoteToken

O token de memória fornecido remotamente, uma matriz opaca de bytes do consumidor NDK.

[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 a conclusão bem-sucedida dessa solicitação, mas não gera um evento de conclusão na fila de conclusão de saída. No entanto, as solicitações que falham geram uma conclusão 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 ao 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

A função NdkWrite 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 na fila de conclusão (CQ) quando a solicitação de trabalho for concluída.
STATUS_CONNECTION_INVALID
 O QP (par de filas) não está conectado.
Outros códigos status
 Ocorreu um erro.

Comentários

NdkWrite posta uma solicitação de gravação em um QP (par de filas).

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

Esquema de processamento adiado do NDKPI

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

NDK_QP

NDK_RESULT

NDK_SGE