StrMiniRequestTimeout routine

The stream class driver calls the minidriver's StrMiniRequestTimeout routine to signal to the minidriver that a request has timed out.

Syntax


PHW_REQUEST_TIMEOUT_HANDLER StrMiniRequestTimeout;

VOID StrMiniRequestTimeout(
  _In_ PHW_STREAM_REQUEST_BLOCK pSrb
)
{ ... }

Parameters

pSrb [in]

Pointer to the stream request that has timed out.

Return value

None

Remarks

The minidriver specifies this routine in the HwRequestTimeoutHandler member of its HW_INITIALIZATION_DATA structure. The minidriver passes this structure to the class driver when it registers itself by calling StreamClassRegisterMinidriver.

When the class driver first issues a request, it sets a time-out value (in seconds) with the TimeoutCounter member of the HW_STREAM_REQUEST_BLOCK pointed to by pSrb. The class driver decrements the TimeoutCounter member of that structure once a second. A request times out when the class driver decrements TimeoutCounter to zero, at which time the class driver calls StrMiniRequestTimeout to handle any clean-up necessary to cease processing the request.

Minidrivers that rely on the class driver to handle synchronization should, once they have successfully handled the request time-out, signal to the class driver that they are ready for another request by using StreamClassStreamNotification or StreamClassDeviceNotification with the appropriate ReadyForNextXxxRequest.

Requirements

Target platform

Desktop

Header

Strmini.h (include Strmini.h)

 

 

Send comments about this topic to Microsoft

Show: