Solicitações OID do driver de miniporta CoNDIS

O NDIS chama a função MiniportCoOidRequest de um driver de miniporta CoNDIS para submeter um requerimento de OID com o objetivo de consultar ou definir informações no driver. O NDIS chama MiniportCoOidRequest em seu nome ou em nome de um controlador subjacente que chamou a função NdisCoOidRequest.

O NDIS passa MiniportCoOidRequest um ponteiro para uma estrutura NDIS_OID_REQUEST que contém as informações da solicitação. A estrutura da solicitação contém um identificador OID_Xxx que indica o tipo de solicitação e outros membros para definir os dados da solicitação.

O membro Timeout especifica um tempo limite, em segundos, para a solicitação. O NDIS pode reinicializar o controlador ou cancelar a solicitação se o tempo limite expirar antes que o controlador conclua a solicitação.

O membro RequestId especifica um identificador opcional para a requisição. Os drivers de miniporta podem definir o membro RequestId de uma indicação de status para o valor que o driver obteve do membro RequestId de uma solicitação OID associada. Normalmente, os controladores de miniporta podem ignorar este membro. Se um driver deve definir esse membro, o driver deve usar um dos valores necessários, que são especificados na página de referência para o OID específico. Para obter mais informações sobre indicações de status, consulte Indicações de status do driver CoNDIS Miniport.

Um driver de miniporta pode concluir uma solicitação OID de forma síncrona retornando um status de sucesso ou falha. O driver pode concluir uma solicitação OID de forma assíncrona retornando NDIS_STATUS_PENDING. Nesse caso, o driver deve chamar a função NdisMCoOidRequestComplete para concluir a operação.

Se a função MiniportCoOidRequest retornar NDIS_STATUS_PENDING, o NDIS poderá chamar MiniportCoOidRequest com outra solicitação para o adaptador antes que a solicitação pendente seja concluída. Observe que isso é diferente da interface NDIS sem conexão, onde todas as solicitações OID são serializadas.

O NDIS pode chamar a função MiniportCancelOidRequest de um driver de miniporta para cancelar uma solicitação CoNDIS OID.