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

Artigo
02/07/2025

A função NdkCqNotificationCallback (NDK_FN_CQ_NOTIFICATION_CALLBACK) é chamada pelo provedor NDK para notificar o consumidor sobre um evento CQ (fila de conclusão).

Sintaxe

NDK_FN_CQ_NOTIFICATION_CALLBACK NdkFnCqNotificationCallback;

void NdkFnCqNotificationCallback(
  [in, optional] PVOID CqNotificationContext,
  [in]           NTSTATUS CqStatus
)
{...}

Parâmetros

[in, optional] CqNotificationContext

Uma área de contexto especificada no parâmetro CqNotificationContext da função NdkCreateCq (NDK_FN_CREATE_CQ) quando o objeto CQ (fila de conclusão) foi criado.

[in] CqStatus

Indica o status de erro do CQ. Os seguintes códigos de status são definidos:

Prazo	Descrição
STATUS_SUCCESS	Indica que o CQ está operando normalmente.
STATUS_BUFFER_OVERFLOW	Indica que mais conclusões do que o máximo que o CQ pode conter foram tentadas para serem enfileiradas no CQ e o CQ é inutilizável. Todos os QPs (pares de filas) associados também são inutilizáveis. Nenhuma conclusão futura será relatada. Um erro de STATUS_BUFFER_OVERFLOW geralmente indica um erro de programação.
STATUS_INTERNAL_ERROR	Indica que ocorreu um erro fatal no CQ e o CQ é inutilizável. Todos os QPs (pares de filas) associados também são inutilizáveis. Nenhuma conclusão futura será relatada. Um erro de STATUS_INTERNAL_ERROR geralmente indica um erro de hardware.

Valor de retorno

Nenhum

Observações

Um provedor NDK chama NdkCqNotificationCallback para notificar o consumidor sobre um evento CQ (fila de conclusão).

O consumidor do NDK especificou a função NdkCqNotificationCallback na função CqNotificationContext da função NdkCreateCq (NDK_FN_CREATE_CQ) quando o objeto CQ (fila de conclusão) foi criado.

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

NDK_FN_CREATE_CQ

Partilhar via