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

  • Artigo

A função NdkModifySrq (NDK_FN_MODIFY_SRQ) modifica o tamanho e o limite de notificação de uma SRQ (fila de recebimento compartilhado) 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) NDK (NDK_SRQ).

[in] SrqDepth

O novo tamanho do SRQ. O novo tamanho deve ser menor ou igual ao tamanho especificado no membro MaxSrqDepth 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 enfileiradas ficar abaixo do valor especificado. Se o número de solicitações de recebimento enfileiradas 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 armação.

[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

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.

Comentários

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

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

Requisitos de tempo de vida do objeto NDKPI

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ