SetupDi系列函数整理(二)

SetupDiClassNameFromGuid  通过设备类名得到设备类型的GUID

函数定义

BOOL SetupDiClassNameFromGuid(　　　　　　　　　　　　　

     　　　　　　　　　　　　　　PGUID  ClassGuid,   

   　　　　　　　　　　　　　　  PCHAR  ClassName,   

                                            　　　　  DWORD   ClassNameSize,  

　　　　　　　　　　　　　　　  PDWORD RequiredSize

　　　　　　　　　　　　　　　  )

函数参数

PGUID  ClassGuid

　　提供一个指向GUID的指针给Class Name检索。

PCHAR  ClassName

　　一个指向缓冲区的指针，该缓冲区以NULL字符结尾，其中包含ClassGuid参数所指定的类的名称。

DWORD   ClassNameSize

　　ClassName参数指向的缓冲区的大小，以字符为单位。以NULL字符结尾，以字符为单位的类名的最大大小是MAX_CLASS_NAME_LEN。

 PDWORD RequiredSize

　　一个指向DWORD变量的指针，其接收所需要存储的以NULL结尾的类名的字符的数目。这个指针是可选的，并且可以为NULL。

返回值

　　如果函数运行成功，返回True；否则，返回False。调用GetLastError可以检索记录的错误。

// Delphi从 'SetupApi.dll' 中调用SetupDiClassNameFromGuid函数
function SetupDiClassNameFromGuid(ClassGuid: PGUID; ClassName: PChar;
ClassNameSize: DWORD; RequiredSize: PDWORD): BOOL; stdcall;
external 'Setupapi.dll' name 'SetupDiClassNameFromGuidA';

// Delphi中调用该函数例子
function GetDeviceClassName(GUID: TGUID): PAnsiChar;
var
  ClassName: PChar;
  RequiredSize: DWORD;
begin
  SetupDiClassNameFromGuid(@GUID, nil, 0, @RequiredSize);
  GetMem(ClassName, RequiredSize);
  SetupDiClassNameFromGuid(@GUID, ClassName, RequiredSize, @RequiredSize);
  Result := PAnsiChar(ClassName);
end;