NDIS_RELEASE_MUTEX macro (ndis.h)

Article
02/22/2024

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)

Share via