NDIS_RELEASE_MUTEX macro (ndis.h)
The NDIS_RELEASE_MUTEX macro releases the specified mutex object.
Syntax
void NDIS_RELEASE_MUTEX(
_M_
);
Parameters
_M_
A pointer to an initialized NDIS_MUTEX-type mutex object. The caller initialized the mutex object in a prior call to the NDIS_INIT_MUTEX macro. NDIS_MUTEX is a wrapper for the KMUTEX type.
Return value
NDIS_RELEASE_MUTEX returns a LONG value. If the return value is zero, the mutex object was released and is in the signaled state. If NDIS_RELEASE_MUTEX returns a nonzero value, the mutex is not in the signaled state.
Remarks
NDIS network drivers should use the NDIS_RELEASE_MUTEX macro to release a mutex.
Only the thread that is currently holding the mutex object can release it. Otherwise, a bugcheck occurs. A bugcheck also occurs if a driver attempts to release a mutex object that is in the signaled state.
To acquire the mutex, call the NDIS_WAIT_FOR_MUTEX macro. If a mutex is acquired recursively, the holding thread must call NDIS_RELEASE_MUTEX the same number of times that it acquired the mutex to set it back to the signaled state.
NDIS_RELEASE_MUTEX is an NDIS wrapper for the KeReleaseMutex routine.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported in NDIS 6.0 and later. |
| Target Platform | Universal |
| Header | ndis.h |
| IRQL | PASSIVE_LEVEL |
| DDI compliance rules | Irql_Synch_Function(ndis) |