IDSFDevice Interface

The IDSFDevice interface represents a DSFDevice object, which represents and controls a simulated device.

Members

The IDSFDevice interface inherits from the IDispatch interface. IDSFDevice also defines the following types of members:

  • Methods
  • Properties

Methods

The IDSFDevice interface defines the following methods.

Method Description
get_Children

Gets a collection of devices that are children of this device.

get_Enabled

Determines whether a device is enabled as defined by its hardware interface.

put_Enabled

Determines whether a device is enabled as defined by its hardware interface.

get_Guid

Gets a device's GUID.

put_Guid

Sets a device's GUID.

HasObject

Reports whether an object is associated with the DSFDevice object for the IDSFDevice interface.

get_Hrm

Gets a hardware redirection module for the specified resource type.

get_Inserted

Determines whether the simulated device appears to be physically present in the system.

put_Inserted

Specifies whether the simulated device appears to be physically present in the system.

get_Name

Gets the display name for the device.

put_Name

Sets the display name for the device.

get_Next

Gets the next device in the chain.

put_Next

Sets the next device in the chain.

putref_Next

Sets the next device in the chain.

get_Object

Gets an arbitrary object pointer that is associated with the device object and that a GUID identifies.

put_Object

Sets an arbitrary object pointer that is associated with the device object and that a GUID identifies.

putref_Object

Sets an arbitrary object pointer that is associated with the device object and that a GUID identifies.

get_OpMode

Gets the current operating mode (that is, simulation or capture) for the device.

put_OpMode

Sets the current operating mode (that is, simulation or capture) for the device.

get_Parent

Gets the parent device for the device.

put_Parent

Sets the parent device for the device.

putref_Parent

Sets the parent device for the device.

get_Persistent

Determines whether the simulated device should remain present in the system after the computer restarts.

put_Persistent

Specifies whether the simulated device should remain present in the system after the computer restarts.

get_State

Gets the state bits for the device.

get_SystemDevice

Gets the system device that is associated with this simulation.

SetStateBit

Requests that the device perform the requested operation on the specified bit in the DSFDevice.State bitfield.

This method is reserved for future use.

StartFaultInjection

Requests that the device begin injecting faults into the hardware interface.

This method is reserved for future use.

StopFaultInjection

Requests that the device stop injecting faults requested by an earlier call to StartFaultInjection.

This method is reserved for future use.

 

Properties

The IDSFDevice interface defines the following properties. The preceding table includes access methods for these properties.

Property Access type Description

Children

Read-only

Collection of devices that are children of this device.

Enabled

Read/write

Determines whether a device is enabled as defined by its hardware interface.

Guid

Read/write

Device's GUID.

Hrm

Read-only

Gets a hardware redirection module (HRM) for the specified resource type.

Inserted

Read/write

Indicates whether the simulated device appears to be physically present in the system.

Name

Read/write

Device's display name.

Next

Read/write

Next device in the chain.

Object

Read/write

An arbitrary object pointer that is associated with the device object and that a GUID identifies.

OpMode

Read/write

Device's current operating mode (that is, simulation or capture).

Parent

Read/write

Device's parent device. Typically used by buses for attached devices.

Persistent

Read/write

Indicates whether the simulated device should remain present in the system after the computer restarts.

State

Read-only

Device's state bits. State bits are defined by the device.

SystemDevice

Read-only

The system device that is associated with this simulation.

 

Requirements

Header

Dsfif.h

IDL

Dsfif.idl

 

 

Send comments about this topic to Microsoft

Build date: 9/21/2010