Função NdisOidRequest (ndis.h)
A função NdisOidRequest encaminha uma solicitação para os drivers subjacentes para consultar os recursos ou status de um adaptador ou definir o estado de um adaptador.
Sintaxe
NDIS_STATUS NdisOidRequest(
[in] NDIS_HANDLE NdisBindingHandle,
[in] PNDIS_OID_REQUEST OidRequest
);
Parâmetros
[in] NdisBindingHandle
O identificador retornado pela função NdisOpenAdapterEx que identifica o adaptador 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 quais NDIS_STATUS_ códigoXXXque NdisOidRequest retorna, mas geralmente é um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
|
A operação de solicitação foi concluída com êxito. |
|
A solicitação está sendo tratada de forma assíncrona e o NDIS chamará o chamador Função ProtocolOidRequestComplete quando a solicitação é concluída. |
|
O código OID_XXX especificado no membro Oid do buffer estruturado por NDIS_OID_REQUEST em OidRequest é inválido ou sem suporte pelo driver subjacente. |
|
O valor especificado no membro InformationBufferLength do buffer estruturado por NDIS_OID_REQUEST em OidRequest não corresponde 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 NdisOidRequest. |
|
Os dados fornecidos no InformationBuffer na estrutura de NDIS_OID_REQUEST fornecida são inválidos para o código OID_XXX fornecido. |
|
O driver subjacente não dá suporte à operação solicitada. |
|
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. |
|
O driver subjacente tentou a operação solicitada, geralmente um conjunto em uma NIC, mas falhou. Por exemplo, uma tentativa de definir muitos endereços multicast pode causar o retorno desse valor. |
|
O driver subjacente falhou na operação solicitada porque uma operação de fechamento está em andamento. |
|
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. |
|
Esse valor geralmente é um padrão não específico, retornado quando nenhum dos NDIS_STATUS_XXX mais específicos fez com que o driver subjacente falhasse na solicitação. |
Comentários
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 em OidRequest antes de chamar NdisOidRequest. Ambos os buffers devem ser alocados do pool nãopagado porque o driver subjacente é executado no IRQL gerado durante o processamento da solicitação.
NdisOidRequest encaminha uma solicitação para drivers subjacentes ou manipula a solicitação em si.. Se o driver mais baixo for um driver intermediário do NDIS, ele poderá chamar NdisOidRequest com uma solicitação específica do OID antes de concluir a solicitação originalmente enviada pelo driver de nível superior.
Alguns erros retornados são recuperáveis, incluindo o seguinte:
Ou seja, um driver pode modificar o pacote em OidRequest adequadamente para corrigir o código OID_XXX ou o tamanho ou conteúdo do buffer no InformationBuffer e reenviar o pacote de solicitação para NdisOidRequest. O mesmo pacote poderá ser atendido na ressubmissão para NdisOidRequest se a chamada original indicasse uma redefinição em andamento ou que uma escassez de recursos, que poderia ser temporária, impedisse que essa solicitação fosse realizada.
A biblioteca NDIS mantém associações para drivers de miniportos subjacentes. O NDIS poderá retornar informações para consultas específicas de associação se um determinado OID estiver associado a um tipo médio definido pelo sistema para o qual o sistema fornece uma biblioteca de filtros.
Para obter mais informações sobre os OIDs gerais e específicos da mídia e seus respectivos buffers de informações associados, consulte OIDs do NDIS.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ndis.h (inclua Ndis.h) |
| Biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Regras de conformidade de DDI | Irql_OID_Function(ndis) |