PROTOCOL_OID_REQUEST_COMPLETE função de retorno de chamada (ndis.h)
A função ProtocolOidRequestComplete conclui o processamento de uma solicitação OID iniciada pelo driver de protocolo para a qual a função NdisOidRequest retornou NDIS_STATUS_PENDING.
Sintaxe
PROTOCOL_OID_REQUEST_COMPLETE ProtocolOidRequestComplete;
void ProtocolOidRequestComplete(
[in] NDIS_HANDLE ProtocolBindingContext,
[in] PNDIS_OID_REQUEST OidRequest,
[in] NDIS_STATUS Status
)
{...}
Parâmetros
[in] ProtocolBindingContext
Um identificador para uma área de contexto alocada pelo driver de protocolo na qual o driver de protocolo mantém o estado de tempo de execução por associação. O driver forneceu esse identificador quando chamou a função NdisOpenAdapterEx .
[in] OidRequest
Um ponteiro para a estrutura de NDIS_OID_REQUEST fornecida pelo driver de protocolo que foi passada anteriormente para a função NdisOidRequest .
[in] Status
O status final da solicitação. O driver subjacente ou o NDIS determina esse status final. Esse parâmetro determina o que ProtocolOidRequestComplete faz com as informações em OidRequest.
Retornar valor
Nenhum
Comentários
ProtocolOidRequestComplete usa o valor de entrada de Status da seguinte maneira:
-
Se Status for NDIS_STATUS_SUCCESS, o membro BytesRead ou BytesWritten da estrutura NDIS_OID_REQUEST foi definido pelo NDIS ou pelo driver subjacente para especificar quanta informação fornecida pelo driver de protocolo foi transferida do buffer em InformationBuffer para a NIC em uma operação definida ou quantas informações foram retornadas no InformationBuffer em resposta a uma operação de consulta.
Se o driver de protocolo fez uma consulta, ProtocolOidRequestComplete pode usar os dados retornados em InformationBuffer de qualquer forma determinada pelo driver de protocolo, dependendo do valor do membro Oid .
Por exemplo, se o driver de protocolo iniciou originalmente um OID_GEN_MAXIMUM_SEND_PACKETS consulta, ProtocolOidRequestComplete pode configurar variáveis de estado na área ProtocolBindingContext para limitar o número de envios pendentes que o driver configurará para chamadas subsequentes para a função NdisSendNetBufferLIsts .
-
Se Status for NDIS_STATUS_INVALID_LENGTH ou NDIS_STATUS_BUFFER_TOO_SHORT, o membro BytesNeeded especificará o valor específico do OID do membro InformationBufferLength necessário para executar a operação solicitada.
Nessas circunstâncias, ProtocolOidRequestComplete pode alocar espaço em buffer suficiente para a solicitação, configurar outra estrutura NDIS_OID_REQUEST com o InformationBufferLength e o mesmo Oid necessários e repetir a chamada para a função NdisOidRequest .
ProtocolOidRequestComplete também pode repetir solicitações para determinados outros argumentos xxx NDIS_STATUS_, conforme descrito na referência para a função NdisOidRequest .
- Se Status for um NDIS_STATUS_ valor XXX que é um erro irrecuperável, ProtocolOidRequestComplete deverá liberar a memória alocada para a estrutura NDIS_OID_REQUEST e determinar se o driver deve fechar a associação ou ajustar suas informações de estado específicas de associação para lidar com operações de E/S de rede contínuas na associação.
Para consultas específicas de associação, o NDIS chama a própria função ProtocolOidRequestComplete . Como a biblioteca NDIS mantém associações para todos os drivers de miniporto, o NDIS pode retornar informações específicas da associação apenas sobre drivers subjacentes que relatam seu tipo médio como um para o qual o sistema fornece uma biblioteca de filtros. O NDIS retorna NDIS_STATUS_NOT_SUPPORTED para consultas específicas de associação iniciadas pelo driver de protocolo para outros drivers de miniporta.
Para obter mais informações sobre OIDs definidos pelo sistema, consulte OIDs do NDIS.
ProtocolOidRequestComplete pode ser chamado antes que o driver de protocolo tenha tempo para inspecionar o código de status que NdisOidRequest retorna em Status.
O NDIS chama ProtocolOidRequestComplete em IRQL <= DISPATCH_LEVEL.
Exemplos
Para definir uma função ProtocolOidRequestComplete , primeiro você deve fornecer uma declaração de função que identifique o tipo de função que você está definindo. O Windows fornece um conjunto de tipos de função para drivers. Declarar uma função usando os tipos de função ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para escrever drivers para o sistema operacional Windows.Por exemplo, para definir uma função ProtocolOidRequestComplete chamada "MyOidRequestComplete", use o tipo PROTOCOL_OID_REQUEST_COMPLETE conforme mostrado neste exemplo de código:
PROTOCOL_OID_REQUEST_COMPLETE MyOidRequestComplete;
Em seguida, implemente sua função da seguinte maneira:
_Use_decl_annotations_
VOID
MyOidRequestComplete(
NDIS_HANDLE ProtocolBindingContext,
PNDIS_OID_REQUEST OidRequest,
NDIS_STATUS Status
)
{...}
O tipo de função PROTOCOL_OID_REQUEST_COMPLETE é definido no arquivo de cabeçalho Ndis.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função PROTOCOL_OID_REQUEST_COMPLETE no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers NDIS.
Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Plataforma de Destino | Windows |
| Cabeçalho | ndis.h (inclua Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |