windows-nt/Source/XPSP1/NT/net/ndis/uio/sys/ndisbind.c

1945 lines
50 KiB
C
Raw Normal View History

2020-09-26 03:20:57 -05:00
/*++
Copyright (c) 2000 Microsoft Corporation
Module Name:
ndisbind.c
Abstract:
NDIS protocol entry points and utility routines to handle binding
and unbinding from adapters.
Environment:
Kernel mode only.
Revision History:
arvindm 4/5/2000 Created
--*/
#include "precomp.h"
#define __FILENUMBER 'DNIB'
NDIS_OID ndisuioSupportedSetOids[] =
{
OID_802_11_INFRASTRUCTURE_MODE,
OID_802_11_AUTHENTICATION_MODE,
OID_802_11_RELOAD_DEFAULTS,
OID_802_11_REMOVE_WEP,
OID_802_11_WEP_STATUS,
OID_802_11_BSSID_LIST_SCAN,
OID_802_11_ADD_WEP,
OID_802_11_SSID,
OID_802_11_BSSID,
OID_802_11_BSSID_LIST,
OID_802_11_DISASSOCIATE,
OID_802_11_STATISTICS, // Later used by power management
OID_802_11_POWER_MODE, // Later used by power management
OID_802_11_NETWORK_TYPE_IN_USE,
OID_802_11_RSSI,
OID_802_11_SUPPORTED_RATES,
OID_802_11_CONFIGURATION,
OID_802_3_MULTICAST_LIST
};
VOID
NdisuioBindAdapter(
OUT PNDIS_STATUS pStatus,
IN NDIS_HANDLE BindContext,
IN PNDIS_STRING pDeviceName,
IN PVOID SystemSpecific1,
IN PVOID SystemSpecific2
)
/*++
Routine Description:
Protocol Bind Handler entry point called when NDIS wants us
to bind to an adapter. We go ahead and set up a binding.
An OPEN_CONTEXT structure is allocated to keep state about
this binding.
Arguments:
pStatus - place to return bind status
BindContext - handle to use with NdisCompleteBindAdapter
DeviceName - adapter to bind to
SystemSpecific1 - used to access protocol-specific registry
key for this binding
SystemSpecific2 - unused
Return Value:
None
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
NDIS_STATUS Status, ConfigStatus;
NDIS_HANDLE ConfigHandle;
do
{
//
// Allocate our context for this open.
//
NUIO_ALLOC_MEM(pOpenContext, sizeof(NDISUIO_OPEN_CONTEXT));
if (pOpenContext == NULL)
{
Status = NDIS_STATUS_RESOURCES;
break;
}
//
// Initialize it.
//
NUIO_ZERO_MEM(pOpenContext, sizeof(NDISUIO_OPEN_CONTEXT));
NUIO_SET_SIGNATURE(pOpenContext, oc);
NUIO_INIT_LOCK(&pOpenContext->Lock);
NUIO_INIT_LIST_HEAD(&pOpenContext->PendedReads);
NUIO_INIT_LIST_HEAD(&pOpenContext->PendedWrites);
NUIO_INIT_LIST_HEAD(&pOpenContext->RecvPktQueue);
NUIO_INIT_EVENT(&pOpenContext->PoweredUpEvent);
//
// Start off by assuming that the device below is powered up.
//
NUIO_SIGNAL_EVENT(&pOpenContext->PoweredUpEvent);
//
// Determine the platform we are running on.
//
pOpenContext->bRunningOnWin9x = TRUE;
NdisOpenProtocolConfiguration(
&ConfigStatus,
&ConfigHandle,
(PNDIS_STRING)SystemSpecific1);
if (ConfigStatus == NDIS_STATUS_SUCCESS)
{
PNDIS_CONFIGURATION_PARAMETER pParameter;
NDIS_STRING VersionKey = NDIS_STRING_CONST("Environment");
NdisReadConfiguration(
&ConfigStatus,
&pParameter,
ConfigHandle,
&VersionKey,
NdisParameterInteger);
if ((ConfigStatus == NDIS_STATUS_SUCCESS) &&
((pParameter->ParameterType == NdisParameterInteger) ||
(pParameter->ParameterType == NdisParameterHexInteger)))
{
pOpenContext->bRunningOnWin9x =
(pParameter->ParameterData.IntegerData == NdisEnvironmentWindows);
}
NdisCloseConfiguration(ConfigHandle);
}
NUIO_REF_OPEN(pOpenContext); // Bind
//
// Add it to the global list.
//
NUIO_ACQUIRE_LOCK(&Globals.GlobalLock);
NUIO_INSERT_TAIL_LIST(&Globals.OpenList,
&pOpenContext->Link);
NUIO_RELEASE_LOCK(&Globals.GlobalLock);
//
// Set up the NDIS binding.
//
Status = ndisuioCreateBinding(
pOpenContext,
(PUCHAR)pDeviceName->Buffer,
pDeviceName->Length);
if (Status != NDIS_STATUS_SUCCESS)
{
break;
}
}
while (FALSE);
*pStatus = Status;
return;
}
VOID
NdisuioOpenAdapterComplete(
IN NDIS_HANDLE ProtocolBindingContext,
IN NDIS_STATUS Status,
IN NDIS_STATUS OpenErrorCode
)
/*++
Routine Description:
Completion routine called by NDIS if our call to NdisOpenAdapter
pends. Wake up the thread that called NdisOpenAdapter.
Arguments:
ProtocolBindingContext - pointer to open context structure
Status - status of the open
OpenErrorCode - if unsuccessful, additional information
Return Value:
None
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
pOpenContext = (PNDISUIO_OPEN_CONTEXT)ProtocolBindingContext;
NUIO_STRUCT_ASSERT(pOpenContext, oc);
pOpenContext->BindStatus = Status;
NUIO_SIGNAL_EVENT(&pOpenContext->BindEvent);
}
VOID
NdisuioUnbindAdapter(
OUT PNDIS_STATUS pStatus,
IN NDIS_HANDLE ProtocolBindingContext,
IN NDIS_HANDLE UnbindContext
)
/*++
Routine Description:
NDIS calls this when it wants us to close the binding to an adapter.
Arguments:
pStatus - place to return status of Unbind
ProtocolBindingContext - pointer to open context structure
UnbindContext - to use in NdisCompleteUnbindAdapter if we return pending
Return Value:
None
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
pOpenContext = (PNDISUIO_OPEN_CONTEXT)ProtocolBindingContext;
NUIO_STRUCT_ASSERT(pOpenContext, oc);
//
// Mark this open as having seen an Unbind.
//
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_UNBIND_FLAGS, NUIOO_UNBIND_RECEIVED);
//
// In case we had threads blocked for the device below to be powered
// up, wake them up.
//
NUIO_SIGNAL_EVENT(&pOpenContext->PoweredUpEvent);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
ndisuioShutdownBinding(pOpenContext);
*pStatus = NDIS_STATUS_SUCCESS;
return;
}
VOID
NdisuioCloseAdapterComplete(
IN NDIS_HANDLE ProtocolBindingContext,
IN NDIS_STATUS Status
)
/*++
Routine Description:
Called by NDIS to complete a pended call to NdisCloseAdapter.
We wake up the thread waiting for this completion.
Arguments:
ProtocolBindingContext - pointer to open context structure
Status - Completion status of NdisCloseAdapter
Return Value:
None
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
pOpenContext = (PNDISUIO_OPEN_CONTEXT)ProtocolBindingContext;
NUIO_STRUCT_ASSERT(pOpenContext, oc);
pOpenContext->BindStatus = Status;
NUIO_SIGNAL_EVENT(&pOpenContext->BindEvent);
}
NDIS_STATUS
NdisuioPnPEventHandler(
IN NDIS_HANDLE ProtocolBindingContext,
IN PNET_PNP_EVENT pNetPnPEvent
)
/*++
Routine Description:
Called by NDIS to notify us of a PNP event. The most significant
one for us is power state change.
Arguments:
ProtocolBindingContext - pointer to open context structure
this is NULL for global reconfig events.
pNetPnPEvent - pointer to the PNP event
Return Value:
Our processing status for the PNP event.
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
NDIS_STATUS Status;
pOpenContext = (PNDISUIO_OPEN_CONTEXT)ProtocolBindingContext;
switch (pNetPnPEvent->NetEvent)
{
case NetEventSetPower:
NUIO_STRUCT_ASSERT(pOpenContext, oc);
pOpenContext->PowerState = *(PNET_DEVICE_POWER_STATE)pNetPnPEvent->Buffer;
if (pOpenContext->PowerState > NetDeviceStateD0)
{
//
// The device below is transitioning to a low power state.
// Block any threads attempting to query the device while
// in this state.
//
NUIO_INIT_EVENT(&pOpenContext->PoweredUpEvent);
//
// Wait for any I/O in progress to complete.
//
ndisuioWaitForPendingIO(pOpenContext, FALSE);
//
// Return any receives that we had queued up.
//
ndisuioFlushReceiveQueue(pOpenContext);
DEBUGP(DL_INFO, ("PnPEvent: Open %p, SetPower to %d\n",
pOpenContext, pOpenContext->PowerState));
}
else
{
//
// The device below is powered up.
//
DEBUGP(DL_INFO, ("PnPEvent: Open %p, SetPower ON: %d\n",
pOpenContext, pOpenContext->PowerState));
NUIO_SIGNAL_EVENT(&pOpenContext->PoweredUpEvent);
}
Status = NDIS_STATUS_SUCCESS;
break;
case NetEventQueryPower:
Status = NDIS_STATUS_SUCCESS;
break;
case NetEventBindsComplete:
NUIO_SIGNAL_EVENT(&Globals.BindsComplete);
Status = NDIS_STATUS_SUCCESS;
break;
case NetEventQueryRemoveDevice:
case NetEventCancelRemoveDevice:
case NetEventReconfigure:
case NetEventBindList:
case NetEventPnPCapabilities:
Status = NDIS_STATUS_SUCCESS;
break;
default:
Status = NDIS_STATUS_NOT_SUPPORTED;
break;
}
DEBUGP(DL_INFO, ("PnPEvent: Open %p, Event %d, Status %x\n",
pOpenContext, pNetPnPEvent->NetEvent, Status));
return (Status);
}
VOID
NdisuioProtocolUnloadHandler(
VOID
)
/*++
Routine Description:
NDIS calls this on a usermode request to uninstall us.
Arguments:
None
Return Value:
None
--*/
{
ndisuioDoProtocolUnload();
}
NDIS_STATUS
ndisuioCreateBinding(
IN PNDISUIO_OPEN_CONTEXT pOpenContext,
IN PUCHAR pBindingInfo,
IN ULONG BindingInfoLength
)
/*++
Routine Description:
Utility function to create an NDIS binding to the indicated device,
if no such binding exists.
Here is where we also allocate additional resources (e.g. packet pool)
for the binding.
Things to take care of:
1. Is another thread doing this (or has finished binding) already?
2. Is the binding being closed at this time?
3. NDIS calls our Unbind handler while we are doing this.
These precautions are not needed if this routine is only called from
the context of our BindAdapter handler, but they are here in case
we initiate binding from elsewhere (e.g. on processing a user command).
NOTE: this function blocks and finishes synchronously.
Arguments:
pOpenContext - pointer to open context block
pBindingInfo - pointer to unicode device name string
BindingInfoLength - length in bytes of the above.
Return Value:
NDIS_STATUS_SUCCESS if a binding was successfully set up.
NDIS_STATUS_XXX error code on any failure.
--*/
{
NDIS_STATUS Status;
NDIS_STATUS OpenErrorCode;
UNICODE_STRING DeviceName;
PLIST_ENTRY pEnt;
NDIS_MEDIUM MediumArray[1] = {NdisMedium802_3};
UINT SelectedMediumIndex;
PNDISUIO_OPEN_CONTEXT pTmpOpenContext;
BOOLEAN fDoNotDisturb = FALSE;
BOOLEAN fOpenComplete = FALSE;
ULONG BytesProcessed;
ULONG GenericUlong = 0;
DEBUGP(DL_LOUD, ("CreateBinding: open %p/%x, device [%ws]\n",
pOpenContext, pOpenContext->Flags, pBindingInfo));
Status = NDIS_STATUS_SUCCESS;
do
{
//
// Check if we already have a binding to this device.
//
pTmpOpenContext = ndisuioLookupDevice(pBindingInfo, BindingInfoLength);
if (pTmpOpenContext != NULL)
{
DEBUGP(DL_WARN,
("CreateBinding: Binding to device %ws already exists on open %p\n",
pTmpOpenContext->DeviceName.Buffer, pTmpOpenContext));
NUIO_DEREF_OPEN(pTmpOpenContext); // temp ref added by Lookup
Status = NDIS_STATUS_FAILURE;
break;
}
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
//
// Check if this open context is already bound/binding/closing.
//
if (!NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_IDLE) ||
NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_UNBIND_FLAGS, NUIOO_UNBIND_RECEIVED))
{
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
Status = NDIS_STATUS_NOT_ACCEPTED;
//
// Make sure we don't abort this binding on failure cleanup.
//
fDoNotDisturb = TRUE;
break;
}
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_OPENING);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
//
// Copy in the device name. Add room for a NULL terminator.
//
NUIO_ALLOC_MEM(pOpenContext->DeviceName.Buffer, BindingInfoLength + sizeof(WCHAR));
if (pOpenContext->DeviceName.Buffer == NULL)
{
DEBUGP(DL_WARN, ("CreateBinding: failed to alloc device name buf (%d bytes)\n",
BindingInfoLength + sizeof(WCHAR)));
Status = NDIS_STATUS_RESOURCES;
break;
}
NUIO_COPY_MEM(pOpenContext->DeviceName.Buffer, pBindingInfo, BindingInfoLength);
*(PWCHAR)((PUCHAR)pOpenContext->DeviceName.Buffer + BindingInfoLength) = L'\0';
NdisInitUnicodeString(&pOpenContext->DeviceName, pOpenContext->DeviceName.Buffer);
//
// Allocate packet pools.
//
NdisAllocatePacketPoolEx(
&Status,
&pOpenContext->SendPacketPool,
MIN_SEND_PACKET_POOL_SIZE,
MAX_SEND_PACKET_POOL_SIZE - MIN_SEND_PACKET_POOL_SIZE,
sizeof(NUIO_SEND_PACKET_RSVD));
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: failed to alloc"
" send packet pool: %x\n", Status));
break;
}
NdisSetPacketPoolProtocolId(pOpenContext->SendPacketPool, 0x4);
NdisAllocatePacketPoolEx(
&Status,
&pOpenContext->RecvPacketPool,
MIN_RECV_PACKET_POOL_SIZE,
MAX_RECV_PACKET_POOL_SIZE - MIN_RECV_PACKET_POOL_SIZE,
sizeof(NUIO_RECV_PACKET_RSVD));
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: failed to alloc"
" recv packet pool: %x\n", Status));
break;
}
//
// Buffer pool for receives.
//
NdisAllocateBufferPool(
&Status,
&pOpenContext->RecvBufferPool,
MAX_RECV_PACKET_POOL_SIZE);
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: failed to alloc"
" recv buffer pool: %x\n", Status));
break;
}
//
// If we are running on Win9X, allocate a buffer pool for sends
// as well, since we can't simply cast MDLs to NDIS_BUFFERs.
//
if (pOpenContext->bRunningOnWin9x)
{
NdisAllocateBufferPool(
&Status,
&pOpenContext->SendBufferPool,
MAX_SEND_PACKET_POOL_SIZE);
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: failed to alloc"
" send buffer pool: %x\n", Status));
break;
}
}
//
// Open the adapter.
//
NUIO_INIT_EVENT(&pOpenContext->BindEvent);
NdisOpenAdapter(
&Status,
&OpenErrorCode,
&pOpenContext->BindingHandle,
&SelectedMediumIndex,
&MediumArray[0],
sizeof(MediumArray) / sizeof(NDIS_MEDIUM),
Globals.NdisProtocolHandle,
(NDIS_HANDLE)pOpenContext,
&pOpenContext->DeviceName,
0,
NULL);
if (Status == NDIS_STATUS_PENDING)
{
NUIO_WAIT_EVENT(&pOpenContext->BindEvent, 0);
Status = pOpenContext->BindStatus;
}
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: NdisOpenAdapter (%ws) failed: %x\n",
pOpenContext->DeviceName.Buffer, Status));
break;
}
//
// Note down the fact that we have successfully bound.
// We don't update the state on the open just yet - this
// is to prevent other threads from shutting down the binding.
//
fOpenComplete = TRUE;
//
// Get the friendly name for the adapter. It is not fatal for this
// to fail.
//
(VOID)NdisQueryAdapterInstanceName(
&pOpenContext->DeviceDescr,
pOpenContext->BindingHandle
);
//
// Get Current address
//
Status = ndisuioDoRequest(
pOpenContext,
NdisRequestQueryInformation,
OID_802_3_CURRENT_ADDRESS,
&pOpenContext->CurrentAddress[0],
NUIO_MAC_ADDR_LEN,
&BytesProcessed
);
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: qry current address failed: %x\n",
Status));
break;
}
//
// Get MAC options.
//
Status = ndisuioDoRequest(
pOpenContext,
NdisRequestQueryInformation,
OID_GEN_MAC_OPTIONS,
&pOpenContext->MacOptions,
sizeof(pOpenContext->MacOptions),
&BytesProcessed
);
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: qry MAC options failed: %x\n",
Status));
break;
}
//
// Get the max frame size.
//
Status = ndisuioDoRequest(
pOpenContext,
NdisRequestQueryInformation,
OID_GEN_MAXIMUM_FRAME_SIZE,
&pOpenContext->MaxFrameSize,
sizeof(pOpenContext->MaxFrameSize),
&BytesProcessed
);
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: qry max frame failed: %x\n",
Status));
break;
}
//
// Get the media connect status.
//
Status = ndisuioDoRequest(
pOpenContext,
NdisRequestQueryInformation,
OID_GEN_MEDIA_CONNECT_STATUS,
&GenericUlong,
sizeof(GenericUlong),
&BytesProcessed
);
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("CreateBinding: qry media connect status failed: %x\n",
Status));
break;
}
if (GenericUlong == NdisMediaStateConnected)
{
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_MEDIA_FLAGS, NUIOO_MEDIA_CONNECTED);
}
else
{
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_MEDIA_FLAGS, NUIOO_MEDIA_DISCONNECTED);
}
//
// Assume that the device is powered up.
//
pOpenContext->PowerState = NetDeviceStateD0;
//
// Mark this open. Also check if we received an Unbind while
// we were setting this up.
//
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_ACTIVE);
//
// Did an unbind happen in the meantime?
//
if (NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_UNBIND_FLAGS, NUIOO_UNBIND_RECEIVED))
{
Status = NDIS_STATUS_FAILURE;
}
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
break;
}
while (FALSE);
if ((Status != NDIS_STATUS_SUCCESS) && !fDoNotDisturb)
{
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
//
// Check if we had actually finished opening the adapter.
//
if (fOpenComplete)
{
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_ACTIVE);
}
else if (NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_OPENING))
{
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_FAILED);
}
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
ndisuioShutdownBinding(pOpenContext);
}
DEBUGP(DL_INFO, ("CreateBinding: OpenContext %p, Status %x\n",
pOpenContext, Status));
return (Status);
}
VOID
ndisuioShutdownBinding(
IN PNDISUIO_OPEN_CONTEXT pOpenContext
)
/*++
Routine Description:
Utility function to shut down the NDIS binding, if one exists, on
the specified open. This is written to be called from:
ndisuioCreateBinding - on failure
NdisuioUnbindAdapter
We handle the case where a binding is in the process of being set up.
This precaution is not needed if this routine is only called from
the context of our UnbindAdapter handler, but they are here in case
we initiate unbinding from elsewhere (e.g. on processing a user command).
NOTE: this blocks and finishes synchronously.
Arguments:
pOpenContext - pointer to open context block
Return Value:
None
--*/
{
NDIS_STATUS Status;
BOOLEAN DoCloseBinding = FALSE;
do
{
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
if (NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_OPENING))
{
//
// We are still in the process of setting up this binding.
//
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
break;
}
if (NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_ACTIVE))
{
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_CLOSING);
DoCloseBinding = TRUE;
}
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
if (DoCloseBinding)
{
//
// Wait for any pending sends or requests on
// the binding to complete.
//
ndisuioWaitForPendingIO(pOpenContext, TRUE);
//
// Discard any queued receives.
//
ndisuioFlushReceiveQueue(pOpenContext);
//
// Close the binding now.
//
NUIO_INIT_EVENT(&pOpenContext->BindEvent);
DEBUGP(DL_INFO, ("ShutdownBinding: Closing OpenContext %p,"
" BindingHandle %p\n",
pOpenContext, pOpenContext->BindingHandle));
NdisCloseAdapter(&Status, pOpenContext->BindingHandle);
if (Status == NDIS_STATUS_PENDING)
{
NUIO_WAIT_EVENT(&pOpenContext->BindEvent, 0);
Status = pOpenContext->BindStatus;
}
NUIO_ASSERT(Status == NDIS_STATUS_SUCCESS);
pOpenContext->BindingHandle = NULL;
}
if (DoCloseBinding)
{
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_IDLE);
NUIO_SET_FLAGS(pOpenContext->Flags, NUIOO_UNBIND_FLAGS, 0);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
}
//
// Remove it from the global list.
//
NUIO_ACQUIRE_LOCK(&Globals.GlobalLock);
NUIO_REMOVE_ENTRY_LIST(&pOpenContext->Link);
NUIO_RELEASE_LOCK(&Globals.GlobalLock);
//
// Free any other resources allocated for this bind.
//
ndisuioFreeBindResources(pOpenContext);
NUIO_DEREF_OPEN(pOpenContext); // Shutdown binding
break;
}
while (FALSE);
}
VOID
ndisuioFreeBindResources(
IN PNDISUIO_OPEN_CONTEXT pOpenContext
)
/*++
Routine Description:
Free any resources set up for an NDIS binding.
Arguments:
pOpenContext - pointer to open context block
Return Value:
None
--*/
{
if (pOpenContext->SendPacketPool != NULL)
{
NdisFreePacketPool(pOpenContext->SendPacketPool);
pOpenContext->SendPacketPool = NULL;
}
if (pOpenContext->RecvPacketPool != NULL)
{
NdisFreePacketPool(pOpenContext->RecvPacketPool);
pOpenContext->RecvPacketPool = NULL;
}
if (pOpenContext->RecvBufferPool != NULL)
{
NdisFreeBufferPool(pOpenContext->RecvBufferPool);
pOpenContext->RecvBufferPool = NULL;
}
if (pOpenContext->SendBufferPool != NULL)
{
NdisFreeBufferPool(pOpenContext->SendBufferPool);
pOpenContext->SendBufferPool = NULL;
}
if (pOpenContext->DeviceName.Buffer != NULL)
{
NUIO_FREE_MEM(pOpenContext->DeviceName.Buffer);
pOpenContext->DeviceName.Buffer = NULL;
pOpenContext->DeviceName.Length =
pOpenContext->DeviceName.MaximumLength = 0;
}
if (pOpenContext->DeviceDescr.Buffer != NULL)
{
//
// this would have been allocated by NdisQueryAdpaterInstanceName.
//
NdisFreeMemory(pOpenContext->DeviceDescr.Buffer, 0, 0);
pOpenContext->DeviceDescr.Buffer = NULL;
}
}
VOID
ndisuioWaitForPendingIO(
IN PNDISUIO_OPEN_CONTEXT pOpenContext,
IN BOOLEAN DoCancelReads
)
/*++
Routine Description:
Utility function to wait for all outstanding I/O to complete
on an open context. It is assumed that the open context
won't go away while we are in this routine.
Arguments:
pOpenContext - pointer to open context structure
DoCancelReads - do we wait for pending reads to go away (and cancel them)?
Return Value:
None
--*/
{
NDIS_STATUS Status;
ULONG LoopCount;
ULONG PendingCount;
#ifdef NDIS51
//
// Wait for any pending sends or requests on the binding to complete.
//
for (LoopCount = 0; LoopCount < 60; LoopCount++)
{
Status = NdisQueryPendingIOCount(
pOpenContext->BindingHandle,
&PendingCount);
if ((Status != NDIS_STATUS_SUCCESS) ||
(PendingCount == 0))
{
break;
}
DEBUGP(DL_INFO, ("WaitForPendingIO: Open %p, %d pending I/O at NDIS\n",
pOpenContext, PendingCount));
NUIO_SLEEP(2);
}
NUIO_ASSERT(LoopCount < 60);
#endif // NDIS51
//
// Make sure any threads trying to send have finished.
//
for (LoopCount = 0; LoopCount < 60; LoopCount++)
{
if (pOpenContext->PendedSendCount == 0)
{
break;
}
DEBUGP(DL_WARN, ("WaitForPendingIO: Open %p, %d pended sends\n",
pOpenContext, pOpenContext->PendedSendCount));
NUIO_SLEEP(1);
}
NUIO_ASSERT(LoopCount < 60);
if (DoCancelReads)
{
//
// Wait for any pended reads to complete/cancel.
//
while (pOpenContext->PendedReadCount != 0)
{
DEBUGP(DL_INFO, ("WaitForPendingIO: Open %p, %d pended reads\n",
pOpenContext, pOpenContext->PendedReadCount));
//
// Cancel any pending reads.
//
ndisuioCancelPendingReads(pOpenContext);
NUIO_SLEEP(1);
}
}
}
VOID
ndisuioDoProtocolUnload(
VOID
)
/*++
Routine Description:
Utility routine to handle unload from the NDIS protocol side.
Arguments:
None
Return Value:
None
--*/
{
NDIS_HANDLE ProtocolHandle;
NDIS_STATUS Status;
DEBUGP(DL_INFO, ("ProtocolUnload: ProtocolHandle %lx\n",
Globals.NdisProtocolHandle));
if (Globals.NdisProtocolHandle != NULL)
{
ProtocolHandle = Globals.NdisProtocolHandle;
Globals.NdisProtocolHandle = NULL;
NdisDeregisterProtocol(
&Status,
ProtocolHandle
);
}
}
NDIS_STATUS
ndisuioDoRequest(
IN PNDISUIO_OPEN_CONTEXT pOpenContext,
IN NDIS_REQUEST_TYPE RequestType,
IN NDIS_OID Oid,
IN PVOID InformationBuffer,
IN UINT InformationBufferLength,
OUT PUINT pBytesProcessed
)
/*++
Routine Description:
Utility routine that forms and sends an NDIS_REQUEST to the
miniport, waits for it to complete, and returns status
to the caller.
NOTE: this assumes that the calling routine ensures validity
of the binding handle until this returns.
Arguments:
pOpenContext - pointer to our open context
RequestType - NdisRequest[Set|Query]Information
Oid - the object being set/queried
InformationBuffer - data for the request
InformationBufferLength - length of the above
pBytesProcessed - place to return bytes read/written
Return Value:
Status of the set/query request
--*/
{
NDISUIO_REQUEST ReqContext;
PNDIS_REQUEST pNdisRequest = &ReqContext.Request;
NDIS_STATUS Status;
NUIO_INIT_EVENT(&ReqContext.ReqEvent);
pNdisRequest->RequestType = RequestType;
switch (RequestType)
{
case NdisRequestQueryInformation:
pNdisRequest->DATA.QUERY_INFORMATION.Oid = Oid;
pNdisRequest->DATA.QUERY_INFORMATION.InformationBuffer =
InformationBuffer;
pNdisRequest->DATA.QUERY_INFORMATION.InformationBufferLength =
InformationBufferLength;
break;
case NdisRequestSetInformation:
pNdisRequest->DATA.SET_INFORMATION.Oid = Oid;
pNdisRequest->DATA.SET_INFORMATION.InformationBuffer =
InformationBuffer;
pNdisRequest->DATA.SET_INFORMATION.InformationBufferLength =
InformationBufferLength;
break;
default:
NUIO_ASSERT(FALSE);
break;
}
NdisRequest(&Status,
pOpenContext->BindingHandle,
pNdisRequest);
if (Status == NDIS_STATUS_PENDING)
{
NUIO_WAIT_EVENT(&ReqContext.ReqEvent, 0);
Status = ReqContext.Status;
}
if (Status == NDIS_STATUS_SUCCESS)
{
*pBytesProcessed = (RequestType == NdisRequestQueryInformation)?
pNdisRequest->DATA.QUERY_INFORMATION.BytesWritten:
pNdisRequest->DATA.SET_INFORMATION.BytesRead;
//
// The driver below should set the correct value to BytesWritten
// or BytesRead. But now, we just truncate the value to InformationBufferLength if
// BytesWritten or BytesRead is greater than InformationBufferLength
//
if (*pBytesProcessed > InformationBufferLength)
{
*pBytesProcessed = InformationBufferLength;
}
}
return (Status);
}
NDIS_STATUS
ndisuioValidateOpenAndDoRequest(
IN PNDISUIO_OPEN_CONTEXT pOpenContext,
IN NDIS_REQUEST_TYPE RequestType,
IN NDIS_OID Oid,
IN PVOID InformationBuffer,
IN UINT InformationBufferLength,
OUT PUINT pBytesProcessed,
IN BOOLEAN bWaitForPowerOn
)
/*++
Routine Description:
Utility routine to prevalidate and reference an open context
before calling ndisuioDoRequest. This routine makes sure
we have a valid binding.
Arguments:
pOpenContext - pointer to our open context
RequestType - NdisRequest[Set|Query]Information
Oid - the object being set/queried
InformationBuffer - data for the request
InformationBufferLength - length of the above
pBytesProcessed - place to return bytes read/written
bWaitForPowerOn - Wait for the device to be powered on if it isn't already.
Return Value:
Status of the set/query request
--*/
{
NDIS_STATUS Status;
do
{
if (pOpenContext == NULL)
{
DEBUGP(DL_WARN, ("ValidateOpenAndDoRequest: request on unassociated file object!\n"));
Status = NDIS_STATUS_INVALID_DATA;
break;
}
NUIO_STRUCT_ASSERT(pOpenContext, oc);
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
//
// Proceed only if we have a binding.
//
if (!NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_ACTIVE))
{
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
Status = NDIS_STATUS_INVALID_DATA;
break;
}
NUIO_ASSERT(pOpenContext->BindingHandle != NULL);
//
// Make sure that the binding does not go away until we
// are finished with the request.
//
NdisInterlockedIncrement(&pOpenContext->PendedSendCount);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
if (bWaitForPowerOn)
{
//
// Wait for the device below to be powered up.
// We don't wait indefinitely here - this is to avoid
// a PROCESS_HAS_LOCKED_PAGES bugcheck that could happen
// if the calling process terminates, and this IRP doesn't
// complete within a reasonable time. An alternative would
// be to explicitly handle cancellation of this IRP.
//
NUIO_WAIT_EVENT(&pOpenContext->PoweredUpEvent, 4500);
}
Status = ndisuioDoRequest(
pOpenContext,
RequestType,
Oid,
InformationBuffer,
InformationBufferLength,
pBytesProcessed);
//
// Let go of the binding.
//
NdisInterlockedDecrement(&pOpenContext->PendedSendCount);
break;
}
while (FALSE);
DEBUGP(DL_LOUD, ("ValidateOpenAndDoReq: Open %p/%x, OID %x, Status %x\n",
pOpenContext, pOpenContext->Flags, Oid, Status));
return (Status);
}
VOID
NdisuioResetComplete(
IN NDIS_HANDLE ProtocolBindingContext,
IN NDIS_STATUS Status
)
/*++
Routine Description:
NDIS entry point indicating that a protocol initiated reset
has completed. Since we never call NdisReset(), this should
never be called.
Arguments:
ProtocolBindingContext - pointer to open context
Status - status of reset completion
Return Value:
None
--*/
{
ASSERT(FALSE);
return;
}
VOID
NdisuioRequestComplete(
IN NDIS_HANDLE ProtocolBindingContext,
IN PNDIS_REQUEST pNdisRequest,
IN NDIS_STATUS Status
)
/*++
Routine Description:
NDIS entry point indicating completion of a pended NDIS_REQUEST.
Arguments:
ProtocolBindingContext - pointer to open context
pNdisRequest - pointer to NDIS request
Status - status of reset completion
Return Value:
None
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
PNDISUIO_REQUEST pReqContext;
pOpenContext = (PNDISUIO_OPEN_CONTEXT)ProtocolBindingContext;
NUIO_STRUCT_ASSERT(pOpenContext, oc);
//
// Get at the request context.
//
pReqContext = CONTAINING_RECORD(pNdisRequest, NDISUIO_REQUEST, Request);
//
// Save away the completion status.
//
pReqContext->Status = Status;
//
// Wake up the thread blocked for this request to complete.
//
NUIO_SIGNAL_EVENT(&pReqContext->ReqEvent);
}
VOID
NdisuioStatus(
IN NDIS_HANDLE ProtocolBindingContext,
IN NDIS_STATUS GeneralStatus,
IN PVOID StatusBuffer,
IN UINT StatusBufferSize
)
/*++
Routine Description:
Protocol entry point called by NDIS to indicate a change
in status at the miniport.
We make note of reset and media connect status indications.
Arguments:
ProtocolBindingContext - pointer to open context
GeneralStatus - status code
StatusBuffer - status-specific additional information
StatusBufferSize - size of the above
Return Value:
None
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
pOpenContext = (PNDISUIO_OPEN_CONTEXT)ProtocolBindingContext;
NUIO_STRUCT_ASSERT(pOpenContext, oc);
DEBUGP(DL_INFO, ("Status: Open %p, Status %x\n",
pOpenContext, GeneralStatus));
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
do
{
if (pOpenContext->PowerState != NetDeviceStateD0)
{
//
// Ignore status indications if the device is in
// a low power state.
//
DEBUGP(DL_INFO, ("Status: Open %p in power state %d,"
" Status %x ignored\n", pOpenContext,
pOpenContext->PowerState, GeneralStatus));
break;
}
switch(GeneralStatus)
{
case NDIS_STATUS_RESET_START:
NUIO_ASSERT(!NUIO_TEST_FLAGS(pOpenContext->Flags,
NUIOO_RESET_FLAGS,
NUIOO_RESET_IN_PROGRESS));
NUIO_SET_FLAGS(pOpenContext->Flags,
NUIOO_RESET_FLAGS,
NUIOO_RESET_IN_PROGRESS);
break;
case NDIS_STATUS_RESET_END:
NUIO_ASSERT(NUIO_TEST_FLAGS(pOpenContext->Flags,
NUIOO_RESET_FLAGS,
NUIOO_RESET_IN_PROGRESS));
NUIO_SET_FLAGS(pOpenContext->Flags,
NUIOO_RESET_FLAGS,
NUIOO_NOT_RESETTING);
break;
case NDIS_STATUS_MEDIA_CONNECT:
NUIO_SET_FLAGS(pOpenContext->Flags,
NUIOO_MEDIA_FLAGS,
NUIOO_MEDIA_CONNECTED);
break;
case NDIS_STATUS_MEDIA_DISCONNECT:
NUIO_SET_FLAGS(pOpenContext->Flags,
NUIOO_MEDIA_FLAGS,
NUIOO_MEDIA_DISCONNECTED);
break;
default:
break;
}
}
while (FALSE);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
}
VOID
NdisuioStatusComplete(
IN NDIS_HANDLE ProtocolBindingContext
)
/*++
Routine Description:
Protocol entry point called by NDIS. We ignore this.
Arguments:
ProtocolBindingContext - pointer to open context
Return Value:
None
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
pOpenContext = (PNDISUIO_OPEN_CONTEXT)ProtocolBindingContext;
NUIO_STRUCT_ASSERT(pOpenContext, oc);
return;
}
NDIS_STATUS
ndisuioQueryBinding(
IN PUCHAR pBuffer,
IN ULONG InputLength,
IN ULONG OutputLength,
OUT PULONG pBytesReturned
)
/*++
Routine Description:
Return information about the specified binding.
Arguments:
pBuffer - pointer to NDISUIO_QUERY_BINDING
InputLength - input buffer size
OutputLength - output buffer size
pBytesReturned - place to return copied byte count.
Return Value:
NDIS_STATUS_SUCCESS if successful, failure code otherwise.
--*/
{
PNDISUIO_QUERY_BINDING pQueryBinding;
PNDISUIO_OPEN_CONTEXT pOpenContext;
PLIST_ENTRY pEnt;
ULONG Remaining;
ULONG BindingIndex;
NDIS_STATUS Status;
do
{
if (InputLength < sizeof(NDISUIO_QUERY_BINDING))
{
Status = NDIS_STATUS_RESOURCES;
break;
}
if (OutputLength < sizeof(NDISUIO_QUERY_BINDING))
{
Status = NDIS_STATUS_BUFFER_OVERFLOW;
break;
}
Remaining = OutputLength - sizeof(NDISUIO_QUERY_BINDING);
pQueryBinding = (PNDISUIO_QUERY_BINDING)pBuffer;
BindingIndex = pQueryBinding->BindingIndex;
Status = NDIS_STATUS_ADAPTER_NOT_FOUND;
pOpenContext = NULL;
NUIO_ACQUIRE_LOCK(&Globals.GlobalLock);
for (pEnt = Globals.OpenList.Flink;
pEnt != &Globals.OpenList;
pEnt = pEnt->Flink)
{
pOpenContext = CONTAINING_RECORD(pEnt, NDISUIO_OPEN_CONTEXT, Link);
NUIO_STRUCT_ASSERT(pOpenContext, oc);
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
//
// Skip if not bound.
//
if (!NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_ACTIVE))
{
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
continue;
}
if (BindingIndex == 0)
{
//
// Got the binding we are looking for. Copy the device
// name and description strings to the output buffer.
//
DEBUGP(DL_INFO,
("QueryBinding: found open %p\n", pOpenContext));
pQueryBinding->DeviceNameLength = pOpenContext->DeviceName.Length + sizeof(WCHAR);
pQueryBinding->DeviceDescrLength = pOpenContext->DeviceDescr.Length + sizeof(WCHAR);
if (Remaining < pQueryBinding->DeviceNameLength +
pQueryBinding->DeviceDescrLength)
{
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
Status = NDIS_STATUS_BUFFER_OVERFLOW;
break;
}
NUIO_ZERO_MEM((PUCHAR)pBuffer + sizeof(NDISUIO_QUERY_BINDING),
pQueryBinding->DeviceNameLength +
pQueryBinding->DeviceDescrLength);
pQueryBinding->DeviceNameOffset = sizeof(NDISUIO_QUERY_BINDING);
NUIO_COPY_MEM((PUCHAR)pBuffer + pQueryBinding->DeviceNameOffset,
pOpenContext->DeviceName.Buffer,
pOpenContext->DeviceName.Length);
pQueryBinding->DeviceDescrOffset = pQueryBinding->DeviceNameOffset +
pQueryBinding->DeviceNameLength;
NUIO_COPY_MEM((PUCHAR)pBuffer + pQueryBinding->DeviceDescrOffset,
pOpenContext->DeviceDescr.Buffer,
pOpenContext->DeviceDescr.Length);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
*pBytesReturned = pQueryBinding->DeviceDescrOffset + pQueryBinding->DeviceDescrLength;
Status = NDIS_STATUS_SUCCESS;
break;
}
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
BindingIndex--;
}
NUIO_RELEASE_LOCK(&Globals.GlobalLock);
}
while (FALSE);
return (Status);
}
PNDISUIO_OPEN_CONTEXT
ndisuioLookupDevice(
IN PUCHAR pBindingInfo,
IN ULONG BindingInfoLength
)
/*++
Routine Description:
Search our global list for an open context structure that
has a binding to the specified device, and return a pointer
to it.
NOTE: we reference the open that we return.
Arguments:
pBindingInfo - pointer to unicode device name string
BindingInfoLength - length in bytes of the above.
Return Value:
Pointer to the matching open context if found, else NULL
--*/
{
PNDISUIO_OPEN_CONTEXT pOpenContext;
PLIST_ENTRY pEnt;
pOpenContext = NULL;
NUIO_ACQUIRE_LOCK(&Globals.GlobalLock);
for (pEnt = Globals.OpenList.Flink;
pEnt != &Globals.OpenList;
pEnt = pEnt->Flink)
{
pOpenContext = CONTAINING_RECORD(pEnt, NDISUIO_OPEN_CONTEXT, Link);
NUIO_STRUCT_ASSERT(pOpenContext, oc);
//
// Check if this has the name we are looking for.
//
if ((pOpenContext->DeviceName.Length == BindingInfoLength) &&
NUIO_MEM_CMP(pOpenContext->DeviceName.Buffer, pBindingInfo, BindingInfoLength))
{
NUIO_REF_OPEN(pOpenContext); // ref added by LookupDevice
break;
}
pOpenContext = NULL;
}
NUIO_RELEASE_LOCK(&Globals.GlobalLock);
return (pOpenContext);
}
NDIS_STATUS
ndisuioQueryOidValue(
IN PNDISUIO_OPEN_CONTEXT pOpenContext,
OUT PVOID pDataBuffer,
IN ULONG BufferLength,
OUT PULONG pBytesWritten
)
/*++
Routine Description:
Query an arbitrary OID value from the miniport.
Arguments:
pOpenContext - pointer to open context representing our binding to the miniport
pDataBuffer - place to store the returned value
BufferLength - length of the above
pBytesWritten - place to return length returned
Return Value:
NDIS_STATUS_SUCCESS if we successfully queried the OID.
NDIS_STATUS_XXX error code otherwise.
--*/
{
NDIS_STATUS Status;
PNDISUIO_QUERY_OID pQuery;
NDIS_OID Oid;
Oid = 0;
do
{
if (BufferLength < sizeof(NDISUIO_QUERY_OID))
{
Status = NDIS_STATUS_BUFFER_TOO_SHORT;
break;
}
pQuery = (PNDISUIO_QUERY_OID)pDataBuffer;
Oid = pQuery->Oid;
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
if (!NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_ACTIVE))
{
DEBUGP(DL_WARN,
("QueryOid: Open %p/%x is in invalid state\n",
pOpenContext, pOpenContext->Flags));
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
Status = NDIS_STATUS_FAILURE;
break;
}
//
// Make sure the binding doesn't go away.
//
NdisInterlockedIncrement(&pOpenContext->PendedSendCount);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
Status = ndisuioDoRequest(
pOpenContext,
NdisRequestQueryInformation,
Oid,
&pQuery->Data[0],
BufferLength - FIELD_OFFSET(NDISUIO_QUERY_OID, Data),
pBytesWritten);
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
NdisInterlockedDecrement(&pOpenContext->PendedSendCount);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
if (Status == NDIS_STATUS_SUCCESS)
{
*pBytesWritten += FIELD_OFFSET(NDISUIO_QUERY_OID, Data);
}
}
while (FALSE);
DEBUGP(DL_LOUD, ("QueryOid: Open %p/%x, OID %x, Status %x\n",
pOpenContext, pOpenContext->Flags, Oid, Status));
return (Status);
}
NDIS_STATUS
ndisuioSetOidValue(
IN PNDISUIO_OPEN_CONTEXT pOpenContext,
OUT PVOID pDataBuffer,
IN ULONG BufferLength
)
/*++
Routine Description:
Set an arbitrary OID value to the miniport.
Arguments:
pOpenContext - pointer to open context representing our binding to the miniport
pDataBuffer - buffer that contains the value to be set
BufferLength - length of the above
Return Value:
NDIS_STATUS_SUCCESS if we successfully set the OID
NDIS_STATUS_XXX error code otherwise.
--*/
{
NDIS_STATUS Status;
PNDISUIO_SET_OID pSet;
NDIS_OID Oid;
ULONG BytesWritten;
Oid = 0;
do
{
if (BufferLength < sizeof(NDISUIO_SET_OID))
{
Status = NDIS_STATUS_BUFFER_TOO_SHORT;
break;
}
pSet = (PNDISUIO_SET_OID)pDataBuffer;
Oid = pSet->Oid;
//
// We should check the OID is settable by the user mode apps
//
if (!ndisuioValidOid(Oid))
{
DEBUGP(DL_WARN, ("SetOid: Oid %x cannot be set\n", Oid));
Status = NDIS_STATUS_INVALID_DATA;
break;
}
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
if (!NUIO_TEST_FLAGS(pOpenContext->Flags, NUIOO_BIND_FLAGS, NUIOO_BIND_ACTIVE))
{
DEBUGP(DL_WARN,
("SetOid: Open %p/%x is in invalid state\n",
pOpenContext, pOpenContext->Flags));
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
Status = NDIS_STATUS_FAILURE;
break;
}
//
// Make sure the binding doesn't go away.
//
NdisInterlockedIncrement(&pOpenContext->PendedSendCount);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
Status = ndisuioDoRequest(
pOpenContext,
NdisRequestSetInformation,
Oid,
&pSet->Data[0],
BufferLength - FIELD_OFFSET(NDISUIO_SET_OID, Data),
&BytesWritten);
NUIO_ACQUIRE_LOCK(&pOpenContext->Lock);
NdisInterlockedDecrement(&pOpenContext->PendedSendCount);
NUIO_RELEASE_LOCK(&pOpenContext->Lock);
}
while (FALSE);
DEBUGP(DL_LOUD, ("SetOid: Open %p/%x, OID %x, Status %x\n",
pOpenContext, pOpenContext->Flags, Oid, Status));
return (Status);
}
BOOLEAN
ndisuioValidOid(
IN NDIS_OID Oid
)
/*++
Routine Description:
Validate whether the given set OID is settable or not.
Arguments:
Oid - The OID which the user tries to set.
Return Value:
TRUE if the OID is allowed to set
FALSE otherwise.
--*/
{
UINT i;
UINT NumOids;
NumOids = sizeof(ndisuioSupportedSetOids) / sizeof(NDIS_OID);
for (i = 0; i < NumOids; i++)
{
if (ndisuioSupportedSetOids[i] == Oid)
{
break;
}
}
return (i < NumOids);
}