Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function requests the number of I/O operations that the specified adapter is currently processing.
NDIS_STATUS NdisQueryPendingIoCount(PVOID NdisBindingHandle,PULONG IoCount);
Parameters
- NdisBindingHandle
[in] Specifies the handle returned by NdisOpenAdapter that identifies the target NIC or the virtual adapter of the next-lower driver to which the caller is bound. - IoCount
[out] Points to a caller-supplied variable into which NDIS writes the number of outstanding I/O operations. I/O operations include sending packets and requests to set or retrieve information maintained by the specified adapter's miniport. A zero count indicates that the specified adapter is not processing any I/O operations.
Return Values
The following table shows the return values for this function.
| Value | Description |
|---|---|
| NDIS_STATUS_SUCCESS | The driver successfully returned the number of outstanding I/O operations. |
| NDIS_STATUS_CLOSING | The binding specified by NdisBindingHandle is being released. |
| NDIS_STATUS_FAILURE | The binding handle specified by NdisBindingHandle is invalid. |
Remarks
A protocol driver can call NdisQueryPendingIoCount from its ProtocolPnPEvent function when handling a transition to low-power state to determine when the protocol can safely return from its ProtocolPnPEvent function. When the number of outstanding I/O operations drops to zero, the protocol driver can return from its ProtocolPnPEvent function without inadvertently causing any outstanding I/O operations to be aborted.
Note that, during the call to NdisQueryPendingIoCount, the protocol driver must not request that the adapter identified by NdisBindingHandle perform any new I/O operations (sends or information requests).
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.
See Also
NdisOpenAdapter | ProtocolPnPEvent
Send Feedback on this topic to the authors