/*------------------------------------------------------------------------- ssh_driver_initialize() Sets up virtual NIC so that it is ready for network I/O operations. Arguments: open_error_status - additional error information selected_medium_index - index to specified media type in medium array medium_array - media array medium_array_size - length of media array miniport_handle - handle that identifies virtual NIC configuration_context - handle to registry configuration of virtual NIC Returns: NDIS_STATUS_SUCCESS - initialization succeeded NDIS_STATUS_FAILURE - otherwise Notes: This handler is called after successful binding creation with underlaying NIC. Default IRQL: PASSIVE_LEVEL -------------------------------------------------------------------------*/ static NDIS_STATUS ssh_driver_initialize(PNDIS_STATUS open_error_status, PUINT selected_medium_index, PNDIS_MEDIUM medium_array, UINT medium_array_size, NDIS_HANDLE miniport_handle, NDIS_HANDLE configuration_context) { NDIS_STATUS status; SshNdisIMAdapter adapter; SSH_ASSERT(SSH_GET_IRQL() < SSH_DISPATCH_LEVEL); /* Retrieve the adapter context and then initialize our adapter */ adapter = (SshNdisIMAdapter) NdisIMGetDeviceContext(miniport_handle); SSH_ASSERT(adapter != NULL); SSH_DEBUG(SSH_D_HIGHSTART, ("Adapter %@ MiniportInitialize", ssh_adapter_id_st_render, adapter)); status = ssh_adapter_initialize(adapter, miniport_handle, configuration_context, medium_array_size, medium_array, selected_medium_index); if (status == NDIS_STATUS_SUCCESS) SSH_DEBUG(SSH_D_HIGHOK, ("Adapter %@ MiniportInitialize: status=%@, " "selected medium index %u", ssh_adapter_id_st_render, adapter, ssh_ndis_status_render, &status, *selected_medium_index)); else if (status == NDIS_STATUS_OPEN_FAILED) SSH_DEBUG(SSH_D_FAIL, ("Adapter %@ MiniportInitialize: status=%@, " "open error status %@", ssh_adapter_id_st_render, adapter, ssh_ndis_status_render, &status, ssh_ndis_status_render, open_error_status)); else SSH_DEBUG(SSH_D_FAIL, ("Adapter %@ MiniportInitialize: status=%@", ssh_adapter_id_st_render, adapter, ssh_ndis_status_render, &status)); return (status); }
NDIS_STATUS MPInitialize( OUT PNDIS_STATUS OpenErrorStatus, OUT PUINT SelectedMediumIndex, IN PNDIS_MEDIUM MediumArray, IN UINT MediumArraySize, IN NDIS_HANDLE MiniportAdapterHandle, IN NDIS_HANDLE WrapperConfigurationContext ) /*++ Routine Description: This is the initialize handler which gets called as a result of the BindAdapter handler calling NdisIMInitializeDeviceInstanceEx. The context parameter which we pass there is the adapter structure which we retrieve here. Arguments: OpenErrorStatus Not used by us. SelectedMediumIndex Place-holder for what media we are using MediumArray Array of ndis media passed down to us to pick from MediumArraySize Size of the array MiniportAdapterHandle The handle NDIS uses to refer to us WrapperConfigurationContext For use by NdisOpenConfiguration Return Value: NDIS_STATUS_SUCCESS unless something goes wrong --*/ { UINT i; PADAPT pAdapt; NDIS_STATUS Status = NDIS_STATUS_FAILURE; NDIS_MEDIUM Medium; UNREFERENCED_PARAMETER(WrapperConfigurationContext); do { // // Start off by retrieving our adapter context and storing // the Miniport handle in it. // pAdapt = NdisIMGetDeviceContext(MiniportAdapterHandle); pAdapt->MiniportHandle = MiniportAdapterHandle; DBGPRINT(("==> Miniport Initialize: Adapt %p\n", pAdapt)); // // Usually we export the medium type of the adapter below as our // virtual miniport's medium type. However if the adapter below us // is a WAN device, then we claim to be of medium type 802.3. // Medium = pAdapt->Medium; if (Medium == NdisMediumWan) { Medium = NdisMedium802_3; } for (i = 0; i < MediumArraySize; i++) { if (MediumArray[i] == Medium) { *SelectedMediumIndex = i; break; } } if (i == MediumArraySize) { Status = NDIS_STATUS_UNSUPPORTED_MEDIA; break; } // // Set the attributes now. NDIS_ATTRIBUTE_DESERIALIZE enables us // to make up-calls to NDIS without having to call NdisIMSwitchToMiniport // or NdisIMQueueCallBack. This also forces us to protect our data using // spinlocks where appropriate. Also in this case NDIS does not queue // packets on our behalf. Since this is a very simple pass-thru // miniport, we do not have a need to protect anything. However in // a general case there will be a need to use per-adapter spin-locks // for the packet queues at the very least. // NdisMSetAttributesEx(MiniportAdapterHandle, pAdapt, 0, // CheckForHangTimeInSeconds NDIS_ATTRIBUTE_IGNORE_PACKET_TIMEOUT | NDIS_ATTRIBUTE_IGNORE_REQUEST_TIMEOUT| NDIS_ATTRIBUTE_INTERMEDIATE_DRIVER | NDIS_ATTRIBUTE_DESERIALIZE | NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND, 0); // // Initialize LastIndicatedStatus to be NDIS_STATUS_MEDIA_CONNECT // pAdapt->LastIndicatedStatus = NDIS_STATUS_MEDIA_CONNECT; // // Initialize the power states for both the lower binding (PTDeviceState) // and our miniport edge to Powered On. // pAdapt->MPDeviceState = NdisDeviceStateD0; pAdapt->PTDeviceState = NdisDeviceStateD0; // // Add this adapter to the global pAdapt List // NdisAcquireSpinLock(&GlobalLock); pAdapt->Next = pAdaptList; pAdaptList = pAdapt; NdisReleaseSpinLock(&GlobalLock); // // Create an ioctl interface // (VOID)PtRegisterDevice(); Status = NDIS_STATUS_SUCCESS; } while (FALSE); // // If we had received an UnbindAdapter notification on the underlying // adapter, we would have blocked that thread waiting for the IM Init // process to complete. Wake up any such thread. // ASSERT(pAdapt->MiniportInitPending == TRUE); pAdapt->MiniportInitPending = FALSE; NdisSetEvent(&pAdapt->MiniportInitEvent); DBGPRINT(("<== Miniport Initialize: Adapt %p, Status %x\n", pAdapt, Status)); *OpenErrorStatus = Status; return Status; }
NDIS_STATUS MiniportInitialize5( OUT PNDIS_STATUS OpenErrorStatus, OUT PUINT SelectedMediumIndex, IN PNDIS_MEDIUM MediumArray, IN UINT MediumArraySize, IN NDIS_HANDLE MiniportAdapterHandle, IN NDIS_HANDLE WrapperConfigurationContext ) { UINT i; PADAPTER pAdapt; NDIS_STATUS Status = NDIS_STATUS_FAILURE; NDIS_MEDIUM Medium; UNREFERENCED_PARAMETER(WrapperConfigurationContext); do { pAdapt = NdisIMGetDeviceContext(MiniportAdapterHandle); pAdapt->MiniportHandle = MiniportAdapterHandle; Medium = pAdapt->Medium; if (Medium == NdisMediumWan) { Medium = NdisMedium802_3; pAdapt->bWanAdapter = TRUE; } for (i = 0; i < MediumArraySize; i++) { if (MediumArray[i] == Medium) { *SelectedMediumIndex = i; break; } } if (i == MediumArraySize) { Status = NDIS_STATUS_UNSUPPORTED_MEDIA; break; } NdisMSetAttributesEx(MiniportAdapterHandle, pAdapt, 0, // CheckForHangTimeInSeconds NDIS_ATTRIBUTE_IGNORE_PACKET_TIMEOUT | NDIS_ATTRIBUTE_IGNORE_REQUEST_TIMEOUT| NDIS_ATTRIBUTE_INTERMEDIATE_DRIVER | NDIS_ATTRIBUTE_DESERIALIZE | NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND, 0); pAdapt->LastIndicatedStatus = NDIS_STATUS_MEDIA_CONNECT; pAdapt->MiniportDeviceState = NdisDeviceStateD0; // // Create an ioctl interface // (VOID)ProtocolRegisterDevice(); Status = NDIS_STATUS_SUCCESS; } while (FALSE); ASSERT(pAdapt->MiniportInitPending == TRUE); pAdapt->MiniportInitPending = FALSE; NdisSetEvent(&pAdapt->MiniportInitEvent); *OpenErrorStatus = Status; return Status; }