Solicitações OID do Driver de Miniporto do CoNDIS

O NDIS chama a função MiniportCoOidRequest de um driver de miniport coNDIS para enviar uma solicitação OID para consultar ou definir informações no driver. O NDIS chama MiniportCoOidRequest em seu próprio nome ou em nome de um driver sobressociente que chamou a função NdisCoOidRequest .

O NDIS passa miniportCoOidRequest um ponteiro para uma estrutura NDIS_OID_REQUEST que contém as informações de solicitação. A estrutura de 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 redefinir o driver ou cancelar a solicitação se o tempo limite expirar antes que o driver conclua a solicitação.

O membro RequestId especifica um identificador opcional para a solicitação. Os drivers de miniport podem definir o membro RequestId de um status indicação para o valor que o driver obteve do membro RequestId de uma solicitação OID associada. Normalmente, os drivers de miniporto podem ignorar esse membro. Se um driver precisar definir esse membro, o driver deverá 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 status indicações, consulte Indicações de status do driver de miniporto coNDIS.

Um driver de miniporta pode concluir uma solicitação OID de forma síncrona retornando um status de êxito 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. Você deve observar que isso é diferente da interface NDIS sem conexão em que todas as solicitações OID são serializadas.

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