Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
Windows Mobile Supported Windows Embedded CE Supported
4/14/2010

This function allows devices to request exclusive access to shareable resources.

Syntax 

BOOL ResourceRequestEx (
  DWORD 
dwResId,
  DWORD 
dwId,
  DWORD 
dwLen,
  DWORD 
dwFlags
);

Parameters

dwResId

[in] Resource identifier, which is a label for a set of numbers. The following table shows the existing resource identifiers and their values, which are defined in Resmgr.h.

Resource identifier Value

RESMGR_IRQ

0x00001

RESMGR_IOSPACE

0x00002

Although some resource identifiers are for your use, values below RESMGR_BASE_OEM are reserved. Values greater than RESMGR_MAX_OEM are reserved for future use. The following table shows the resource identifiers that you can use and their values, which are defined in Resmgr.h.

Resource identifier Value

RESMGR_BASE_OEM

0x00080000

RESMGR_MAX_OEM

0x000FFFFF
dwId

[in] Identifer of the resource to request exclusive access.

dwLen

[in] Number of resources to request.

dwFlags

[in] Set to RREXF_REQUEST_EXCLUSIVE to request exclusive access of the shareable resource.

Return Value

TRUE indicates success. FALSE indicates failure.

You cannot have a partial allocation or a partial release of resources.

Remarks

Some devices are not capable of sharing resources. For example, some network cards need exclusive access to interrupt requests (IRQs) even when the IRQ is shareable. Bus drivers should make this request on behalf of the device drivers they load.

Requirements

Header winbase.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later