Package com.ms.com.directX

Previous

Microsoft Packages

Index

Next

Class d3drmObject

Applications use the methods of the d3drmObject class to work with the object superclass of d3drm objects.

public class d3drmObject implements Id3drmObject
{
  public void InternalSetObject(IUnknown lpdd);
  public IUnknown InternalGetObject();
  public void AddDestroyCallback(Id3drmCallback fn, IUnknown Arg);
  public void DeleteDestroyCallback(Id3drmCallback fn, IUnknown args);
  public d3drmObject Clone();
  public void SetAppData(int data);
  public int GetAppData();
  public void SetName(String name);
  public String GetName();
  public String GetClassName();
}

The methods can be organized into the following groups:

Application-specific data	GetAppData
	SetAppData
Cloning	Clone
Naming	GetClassName
	GetName
	SetName
Notifications	AddDestroyCallback
	DeleteDestroyCallback

AddDestroyCallback

public void AddDestroyCallback(Id3drmCallback fn, IUnknown Arg);

Registers a function to be called when an object is destroyed.

Return Value:

No return value.

Parameter	Description
fn	Callback interface that contains a user-defined callback function that will be called when the object is destroyed.
Arg	Application-defined data passed to the callback function. Because this function is called after the object has been destroyed, you should not call this function with the object as an argument.

Clone

public d3drmObject Clone();

Creates a copy of an object.

Return Value:

Returns the d3drmObject object if successful; null otherwise.

DeleteDestroyCallback

public void DeleteDestroyCallback(Id3drmCallback fn, IUnknown args);

Removes a function previously registered with the AddDestroyCallback method.

Return Value:

No return value.

Parameter	Description
fn	Callback interface that contains a user-defined callback function that will be called when the object is destroyed.
args	Application-defined data passed to the callback function.

GetAppData

public int GetAppData();

Retrieves the 32 bits of application-specific data in the object. The default value is 0.

Return Value:

Returns the data value defined by the application.

See Also: SetAppData

GetClassName

public String GetClassName();

Retrieves the name of the object's class.

Return Value:

Returns the name of the class.

GetName

public String GetName();

Retrieves the object's name.

Return Value:

Returns the name of the object.

See Also: SetName

SetAppData

public void SetAppData(int data);

Sets the 32 bits of application-specific data in the object.

Return Value:

No return value.

Parameter	Description
data	User-defined data to be stored with the object.

See Also: GetAppData

SetName

public void SetName(String name);

Sets the object's name.

Return Value:

No return value.

Parameter	Description
name	User-defined data to be the name for the object.

See Also: GetName