CONFIGMG_Register_Arbitrator

CONFIGRET CONFIGMG_Register_Arbitrator(PREGISTERID pRid, RESOURCEID id, CMARBHANDLER Handler, ULONG ulDWordToBePassed, DEVNODE dnArbitratorNode, ULONG ulFlags)

Registers a resource arbitrator.

• Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_API, CR_INVALID_DEVNODE, CR_INVALID_FLAG, CR_INVALID_POINTER, CR_INVALID_RESOURCEID, CR_INVALID_ARBITRATOR or CR_OUT_OF_MEMORY.

pRid

Address that receives the registration identifier of the resource arbitrator.

id

The unique resource number as given or defined by Microsoft Corporation.

Handler

Arbitrator entry point. This is the routine that will handle all arbitrator functions. This parameter cannot be NULL.

ulDWordToBePassed

The value that is passed when calling the arbitrator.

dnArbitratorNode

Handle of the device node that owns this resource. This value is important for local arbitrators, but it can be NULL for a global arbitrator. This value is passed when calling the arbitrator.

ulFlags

Specifies whether the resource is global. If it is ARB_LOCAL, the resource is local to only the children of dnArbitratorNode. Otherwise, it is ARB_GLOBAL.

This function returns CR_INVALID_RESOURCEID if the ResType_Ignored_Bit set in the device identifier.

See also CONFIGMG_Deregister_Arbitrator