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

Artigo
02/07/2025

A função NdkModifySrq (NDK_FN_MODIFY_SRQ) modifica o tamanho e o limite de notificação de uma SRQ (fila de recebimento compartilhado) do NDK.

Sintaxe

NDK_FN_MODIFY_SRQ NdkFnModifySrq;

NTSTATUS NdkFnModifySrq(
  [in]           NDK_SRQ *pNdkSrq,
  [in]           ULONG SrqDepth,
  [in]           ULONG NotifyThreshold,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parâmetros

[in] pNdkSrq

Um ponteiro para um objeto SRQ (fila de recebimento compartilhado) do NDK (NDK_SRQ).

[in] SrqDepth

O novo tamanho do SRQ. O novo tamanho deve ser menor ou igual ao tamanho especificado no maxSrqDepth membro da estrutura NDK_ADAPTER_INFO. Um tamanho de zero significa que nenhuma modificação de profundidade é solicitada. Ou seja, o valor de profundidade srq existente deve ser preservado.

[in] NotifyThreshold

O número de solicitações de recebimento enfileiradas que dispararão um retorno de chamada de notificação SRQ. Se esse valor for maior que zero, o provedor NDK deverá armar a notificação SRQ para disparar quando o número de solicitações de recebimento na fila estiver abaixo do valor especificado. Se o número de solicitações de recebimento na fila já estiver abaixo do valor limite no momento dessa chamada de função, uma notificação SRQ deverá ser gerada. Depois que uma notificação SRQ é gerada, outras notificações são desarmadas até que o consumidor do NDK invoque essa função novamente com um valor limite diferente de zero. Se um valor limite de zero for especificado, o provedor deverá preservar o limite de notificação srq atual e o status de armabilidade.

[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.

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	A solicitaçã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_INVALID_PARAMETER	A solicitação falhou porque o valor no parâmetro SrqDepth não está dentro dos limites especificados na estrutura NDK_ADAPTER_INFO.
Outros códigos de status	Ocorreu um erro.

Observações

NdkModifySrq modifica o tamanho e o limite de notificação de um objeto SRQ (fila de recebimento compartilhado) NDK (NDK_SRQ).

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_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ

Compartilhar via