Export (0) Print
Expand All

IFilterLifespan Interface

This interface allows a filter to manage the lifespan of its in-memory state. The methods in this interface allow for explicit creation and clean-up of a threading model and such things as opening files and connections to external services.


Namespace: Microsoft.Hpc.Scheduler.AddInFilter.HpcClient
Assembly: Microsoft.Hpc.Scheduler (in Microsoft.Hpc.Scheduler.dll)

'Usage
Dim instance As IFilterLifespan

public interface IFilterLifespan
public interface IFilterLifespan
public interface IFilterLifespan

This interface is optional. If IFilterLifespan is implemented, the HPC Job Scheduler Service will call OnFilterLoad after the DLL is loaded, and OnFilterUnload before the DLL is unloaded.

DLL filters are loaded (instantiated) in the following cases:

  • On HPC Job Scheduler Service start-up: When the scheduler starts up, it enumerates all DLL filters that are listed in job templates and loads them.

  • When the DLL filter is first added to a job template: When a cluster administrator specifies a DLL filter in a job template, the HPC Job Scheduler tries to load the DLL as part of validation.

DLL filters are unloaded in the following cases:

  • On HPC Job Scheduler Service clean shutdown: During a clean shutdown, all DLL filters are unloaded.

  • When the last reference to a DLL filter is removed from all job templates: Any time that job templates are changed in the system (added, edited, or removed), the HPC Job Scheduler Service identifies any orphaned filters (loaded filters that are not referenced by any template) and unloads them.

All calls to filter methods are time bounded and are aborted if they exceed the allowed time.

DLLs that contain more than one implementation of this interface are rejected by the HPC Job Scheduler Service.


Development Platforms

Windows XP, Windows Vista, Windows 7, Windows 8, Windows Server 2003, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012

Target Platforms

Windows XP, Windows Vista, Windows 7, Windows 8, Windows Server 2003, Windows Server 2003 R2, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, with HPC Pack Client Utilities




Build Date:

2013-04-22

Community Additions

ADD
Show:
© 2014 Microsoft