Compartilhar via


Função NdisDirectOidRequest (ndis.h)

A função NdisDirectOidRequest encaminha uma solicitação OID direta para os drivers subjacentes para consultar os recursos ou status de um adaptador ou definir o estado de um adaptador.

Sintaxe

NDIS_STATUS NdisDirectOidRequest(
  [in] NDIS_HANDLE       NdisBindingHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

Parâmetros

[in] NdisBindingHandle

O identificador que a função NdisOpenAdapterEx retorna que identifica o adaptador de miniporto de destino na associação.

[in] OidRequest

Um ponteiro para uma estrutura NDIS_OID_REQUEST que especifica a operação solicitada com um determinado código OID_Xxx para consultar o status de um adaptador ou definir o estado de um adaptador.

Retornar valor

O driver subjacente determina qual código NDIS_STATUS_XXXretorna NdisDirectOidRequest , mas geralmente é um dos seguintes valores:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
A operação de solicitação foi concluída com êxito.
NDIS_STATUS_PENDING
A solicitação está sendo tratada de forma assíncrona e o NDIS chamará o chamador Função ProtocolDirectOidRequestComplete quando a solicitação é concluída.
NDIS_STATUS_INVALID_OID
O código OID_Xxx especificado no membro Oid do buffer estruturado NDIS_OID_REQUEST em OidRequest era inválido ou sem suporte pelo driver subjacente.
NDIS_STATUS_INVALID_LENGTH ou NDIS_STATUS_BUFFER_TOO_SHORT
O valor especificado no membro InformationBufferLength do buffer estruturado NDIS_OID_REQUEST em OidRequest não correspondeu aos requisitos do código OID_Xxx fornecido. Se o buffer de informações for muito pequeno, o membro BytesNeeded conterá o valor correto para InformationBufferLength no retorno de NdisDirectOidRequest.
NDIS_STATUS_INVALID_DATA
Os dados fornecidos no InformationBuffer na estrutura de NDIS_OID_REQUEST fornecida eram inválidos para o código OID_Xxx fornecido.
NDIS_STATUS_NOT_SUPPORTED ou NDIS_STATUS_NOT_RECOGNIZED
O driver subjacente não dá suporte à operação solicitada. Para NdisDirectOidRequest, o NDIS também poderá retornar esse status se o driver de chamada não tiver registrado um Função ProtocolDirectOidRequestComplete .
NDIS_STATUS_RESOURCES
A solicitação não pôde ser atendida devido a uma escassez de recursos. Normalmente, esse valor retornado indica que uma tentativa de alocar memória não foi bem-sucedida, mas não indica necessariamente que a mesma solicitação, enviada posteriormente, falhará pelo mesmo motivo.
NDIS_STATUS_NOT_ACCEPTED
O driver subjacente tentou a operação solicitada, normalmente um conjunto em uma NIC, mas falhou. Por exemplo, uma tentativa de definir muitos endereços multicast pode causar o retorno desse valor.
NDIS_STATUS_CLOSING ou NDIS_STATUS_CLOSING_INDICATING
O driver subjacente falhou na operação solicitada porque uma operação de fechamento está em andamento.
NDIS_STATUS_RESET_IN_PROGRESS
O driver de miniporto subjacente não pode atender à solicitação no momento porque está redefinindo a NIC afetada no momento. A função ProtocolStatusEx do chamador foi ou será chamada com NDIS_STATUS_RESET_START para indicar que uma redefinição está em andamento. Esse valor retornado não indica necessariamente que a mesma solicitação, enviada posteriormente, falhará pelo mesmo motivo.
NDIS_STATUS_FAILURE
Esse valor normalmente é um padrão não específico, retornado quando nenhum dos valores NDIS_STATUS_Xxx mais específicos fez com que o driver subjacente falhasse na solicitação.

Comentários

A função NdisDirectOidRequest não pode ser usada para solicitações OID gerais. Para solicitações gerais de OID, use a função NdisOidRequest . NdisDirectOidRequest só pode ser usado para OIDs compatíveis com NDIS para uso com a interface OID direta. Por exemplo, os seguintes OIDs podem ser usados:

OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA

Um driver de protocolo deve alocar memória suficiente para manter o buffer de informações associado ao OID especificado. O driver também deve alocar e configurar o buffer no parâmetro OidRequest antes de chamar NdisDirectOidRequest. Ambos os buffers devem ser alocados do pool nãopagado porque o driver subjacente é executado no IRQL gerado durante o processamento da solicitação.

NdisDirectOidRequest encaminha uma solicitação para drivers subjacentes ou manipula a solicitação em si. Se o driver inferior seguinte for um driver intermediário do NDIS, o driver intermediário poderá chamar NdisDirectOidRequest com uma solicitação específica do OID antes de concluir a solicitação que o driver de nível superior enviou originalmente.

Um driver que chama NdisDirectOidRequest deve registrar o Função ProtocolDirectOidRequestComplete .

A interface de solicitação OID direta é semelhante à interface de solicitação OID geral. Para obter mais informações sobre como emitir solicitações gerais, consulte NdisOidRequest.

Nota Embora as solicitações OID diretas geralmente não sejam serializadas, o próprio NDIS ainda pode aguardar uma solicitação com NDIS_STATUS_PENDING e enfileirar a solicitação para conclusão posterior. Por exemplo, o NDIS pode pendente e enfileirar uma solicitação OID Direta enviada para um miniporto de suspensão seletiva que está atualmente em um estado de baixa energia. Protocolos e filtros devem ser preparados para lidar com um código NDIS_STATUS_PENDING, mesmo que o miniporto subjacente conclua a solicitação de forma síncrona.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.1 e posterior.
Plataforma de Destino Área de Trabalho
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL <= DISPATCH_LEVEL

Confira também

NDIS_OID_REQUEST

NdisOidRequest

NdisOpenAdapterEx

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA ProtocolDirectOidRequestComplete

ProtocolStatusEx