|
JNA API> 4.0.0 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface SetupApi
The interface for the w32 setup API.
Nested Class Summary | |
---|---|
static class |
SetupApi.SP_DEVICE_INTERFACE_DATA
An SP_DEVICE_INTERFACE_DATA structure defines a device interface in a device information set. |
static class |
SetupApi.SP_DEVINFO_DATA
An SP_DEVINFO_DATA structure defines a device instance that is a member of a device information set. |
Nested classes/interfaces inherited from interface com.sun.jna.win32.StdCallLibrary |
---|
StdCallLibrary.StdCallCallback |
Nested classes/interfaces inherited from interface com.sun.jna.Library |
---|
Library.Handler |
Field Summary | |
---|---|
static int |
CM_DEVCAP_REMOVABLE
Removable. |
static int |
DIGCF_ALLCLASSES
Return a list of installed devices for all device setup classes or all device interface classes. |
static int |
DIGCF_DEFAULT
Return only the device that is associated with the system default device interface, if one is set, for the specified device interface classes. |
static int |
DIGCF_DEVICEINTERFACE
Return devices that support device interfaces for the specified device interface classes. |
static int |
DIGCF_PRESENT
Return only devices that are currently present in a system. |
static int |
DIGCF_PROFILE
Return only devices that are a part of the current hardware profile. |
static Guid.GUID |
GUID_DEVINTERFACE_DISK
The GUID_DEVINTERFACE_DISK device interface class is defined for hard disk storage devices. |
static SetupApi |
INSTANCE
|
static int |
SPDRP_REMOVAL_POLICY
(Windows XP and later) The function retrieves the device's current removal policy as a DWORD that contains one of the CM_REMOVAL_POLICY_Xxx values that are defined in Cfgmgr32.h. |
Fields inherited from interface com.sun.jna.win32.StdCallLibrary |
---|
FUNCTION_MAPPER, STDCALL_CONVENTION |
Fields inherited from interface com.sun.jna.Library |
---|
OPTION_ALLOW_OBJECTS, OPTION_CALLING_CONVENTION, OPTION_CLASSLOADER, OPTION_FUNCTION_MAPPER, OPTION_INVOCATION_MAPPER, OPTION_OPEN_FLAGS, OPTION_STRING_ENCODING, OPTION_STRUCTURE_ALIGNMENT, OPTION_TYPE_MAPPER |
Method Summary | |
---|---|
boolean |
SetupDiDestroyDeviceInfoList(WinNT.HANDLE hDevInfo)
The SetupDiDestroyDeviceInfoList function deletes a device information set and frees all associated memory. |
boolean |
SetupDiEnumDeviceInterfaces(WinNT.HANDLE hDevInfo,
Pointer devInfo,
Guid.GUID interfaceClassGuid,
int memberIndex,
SetupApi.SP_DEVICE_INTERFACE_DATA deviceInterfaceData)
The SetupDiEnumDeviceInterfaces function enumerates the device interfaces that are contained in a device information set. |
WinNT.HANDLE |
SetupDiGetClassDevs(Guid.GUID classGuid,
Pointer enumerator,
Pointer hwndParent,
int flags)
The SetupDiGetClassDevs function returns a handle to a device information set that contains requested device information elements for a local computer. |
boolean |
SetupDiGetDeviceInterfaceDetail(WinNT.HANDLE hDevInfo,
SetupApi.SP_DEVICE_INTERFACE_DATA deviceInterfaceData,
Pointer deviceInterfaceDetailData,
int deviceInterfaceDetailDataSize,
IntByReference requiredSize,
SetupApi.SP_DEVINFO_DATA deviceInfoData)
The SetupDiGetDeviceInterfaceDetail function returns details about a device interface. |
boolean |
SetupDiGetDeviceRegistryProperty(WinNT.HANDLE DeviceInfoSet,
SetupApi.SP_DEVINFO_DATA DeviceInfoData,
int Property,
IntByReference PropertyRegDataType,
Pointer PropertyBuffer,
int PropertyBufferSize,
IntByReference RequiredSize)
The SetupDiGetDeviceRegistryProperty function retrieves a specified Plug and Play device property. |
Field Detail |
---|
static final SetupApi INSTANCE
static final Guid.GUID GUID_DEVINTERFACE_DISK
static final int DIGCF_DEFAULT
static final int DIGCF_PRESENT
static final int DIGCF_ALLCLASSES
static final int DIGCF_PROFILE
static final int DIGCF_DEVICEINTERFACE
static final int SPDRP_REMOVAL_POLICY
static final int CM_DEVCAP_REMOVABLE
Method Detail |
---|
WinNT.HANDLE SetupDiGetClassDevs(Guid.GUID classGuid, Pointer enumerator, Pointer hwndParent, int flags)
classGuid
- A pointer to the GUID for a device setup class or a device interface class. This pointer is optional and can be
NULL. For more information about how to set ClassGuid, see the following Remarks section.enumerator
- A pointer to a NULL-terminated string that specifies:
An identifier (ID) of a Plug and Play (PnP) enumerator. This ID can either be the value's globally unique
identifier (GUID) or symbolic name. For example, "PCI" can be used to specify the PCI PnP value. Other examples
of symbolic names for PnP values include "USB," "PCMCIA," and "SCSI".
A PnP device instance ID. When specifying a PnP device instance ID, DIGCF_DEVICEINTERFACE must be set in the
Flags parameter.
This pointer is optional and can be NULL. If an enumeration value is not used to select devices, set Enumerator
to NULL.hwndParent
- A handle to the top-level window to be used for a user interface that is associated with installing a device
instance in the device information set. This handle is optional and can be NULL.flags
- A variable of type DWORD that specifies control options that filter the device information elements that are
added to the device information set.
boolean SetupDiDestroyDeviceInfoList(WinNT.HANDLE hDevInfo)
hDevInfo
- A handle to the device information set to delete.
boolean SetupDiEnumDeviceInterfaces(WinNT.HANDLE hDevInfo, Pointer devInfo, Guid.GUID interfaceClassGuid, int memberIndex, SetupApi.SP_DEVICE_INTERFACE_DATA deviceInterfaceData)
hDevInfo
- A pointer to a device information set that contains the device interfaces for which to return information. This
handle is typically returned by SetupDiGetClassDevs.devInfo
- A pointer to an SP_DEVINFO_DATA structure that specifies a device information element in DeviceInfoSet. This
parameter is optional and can be NULL. If this parameter is specified, SetupDiEnumDeviceInterfaces constrains
the enumeration to the interfaces that are supported by the specified device. If this parameter is NULL,
repeated calls to SetupDiEnumDeviceInterfaces return information about the interfaces that are associated with
all the device information elements in DeviceInfoSet. This pointer is typically returned by
SetupDiEnumDeviceInfo.interfaceClassGuid
- A pointer to a GUID that specifies the device interface class for the requested interface.memberIndex
- A zero-based index into the list of interfaces in the device information set. The caller should call this
function first with MemberIndex set to zero to obtain the first interface. Then, repeatedly increment
MemberIndex and retrieve an interface until this function fails and GetLastError returns ERROR_NO_MORE_ITEMS.
If DeviceInfoData specifies a particular device, the MemberIndex is relative to only the interfaces exposed by
that device.deviceInterfaceData
- A pointer to a caller-allocated buffer that contains, on successful return, a completed
SP_DEVICE_INTERFACE_DATA structure that identifies an interface that meets the search parameters. The caller
must set DeviceInterfaceData.cbSize to sizeof(SP_DEVICE_INTERFACE_DATA) before calling this function.
boolean SetupDiGetDeviceInterfaceDetail(WinNT.HANDLE hDevInfo, SetupApi.SP_DEVICE_INTERFACE_DATA deviceInterfaceData, Pointer deviceInterfaceDetailData, int deviceInterfaceDetailDataSize, IntByReference requiredSize, SetupApi.SP_DEVINFO_DATA deviceInfoData)
hDevInfo
- A pointer to the device information set that contains the interface for which to retrieve details. This handle
is typically returned by SetupDiGetClassDevs.deviceInterfaceData
- A pointer to an SP_DEVICE_INTERFACE_DATA structure that specifies the interface in DeviceInfoSet for which to
retrieve details. A pointer of this type is typically returned by SetupDiEnumDeviceInterfaces.deviceInterfaceDetailData
- A pointer to an SP_DEVICE_INTERFACE_DETAIL_DATA structure to receive information about the specified interface.
This parameter is optional and can be NULL. This parameter must be NULL if DeviceInterfaceDetailSize is zero.
If this parameter is specified, the caller must set DeviceInterfaceDetailData.cbSize to
sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA) before calling this function. The cbSize member always contains the
size of the fixed part of the data structure, not a size reflecting the variable-length string at the end.deviceInterfaceDetailDataSize
- The size of the DeviceInterfaceDetailData buffer. The buffer must be at least
(offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA, DevicePath) + sizeof(TCHAR)) bytes, to contain the fixed part of the
structure and a single NULL to terminate an empty MULTI_SZ string.
This parameter must be zero if DeviceInterfaceDetailData is NULL.requiredSize
- A pointer to a variable of type DWORD that receives the required size of the DeviceInterfaceDetailData buffer.
This size includes the size of the fixed part of the structure plus the number of bytes required for the
variable-length device path string. This parameter is optional and can be NULL.deviceInfoData
- A pointer to a buffer that receives information about the device that supports the requested interface. The
caller must set DeviceInfoData.cbSize to sizeof(SP_DEVINFO_DATA). This parameter is optional and can be NULL.
boolean SetupDiGetDeviceRegistryProperty(WinNT.HANDLE DeviceInfoSet, SetupApi.SP_DEVINFO_DATA DeviceInfoData, int Property, IntByReference PropertyRegDataType, Pointer PropertyBuffer, int PropertyBufferSize, IntByReference RequiredSize)
DeviceInfoSet
- A handle to a device information set that contains a device information element that represents the device for
which to retrieve a Plug and Play property.DeviceInfoData
- A pointer to an SP_DEVINFO_DATA structure that specifies the device information element in DeviceInfoSet.Property
- Specifies the property to be retrieved.PropertyRegDataType
- A pointer to a variable that receives the data type of the property that is being retrieved. This is one of the
standard registry data types. This parameter is optional and can be NULL.PropertyBuffer
- A pointer to a buffer that receives the property that is being retrieved. If this parameter is set to NULL, and
PropertyBufferSize is also set to zero, the function returns the required size for the buffer in RequiredSize.PropertyBufferSize
- The size, in bytes, of the PropertyBuffer buffer.RequiredSize
- A pointer to a variable of type DWORD that receives the required size, in bytes, of the PropertyBuffer buffer
that is required to hold the data for the requested property. This parameter is optional and can be NULL.
|
JNA API> 4.0.0 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |