다음을 통해 공유


SP_DEVINFO_DATA 구조체(setupapi.h)

SP_DEVINFO_DATA 구조는 디바이스 정보 집합의 멤버인 디바이스 instance 정의합니다.

구문

typedef struct _SP_DEVINFO_DATA {
  DWORD     cbSize;
  GUID      ClassGuid;
  DWORD     DevInst;
  ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;

멤버

cbSize

SP_DEVINFO_DATA 구조체의 크기(바이트)입니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

ClassGuid

디바이스 설정 클래스의 GUID입니다.

DevInst

디바이스 instance 대한 불투명 핸들입니다(devnode에 대한 핸들이라고도 함).

SetupDiXxx 함수와 같은 일부 함수는 전체 SP_DEVINFO_DATA 구조를 입력으로 사용하여 디바이스 정보 집합에서 디바이스를 식별합니다. CM_Get_DevNode_Status 같은 CM_Xxx 함수와 같은 다른 함수는 이 DevInst 핸들을 입력으로 사용합니다.

Reserved

예약되어 있습니다. 내부 전용입니다.

설명

SP_DEVINFO_DATA 구조는 디바이스 정보 집합에서 디바이스를 식별합니다. 예를 들어 Windows가 클래스 설치 관리자 및 공동 설치 관리자에게 DIF_INSTALLDEVICE 요청을 보내는 경우 디바이스 정보 집합에 대한 핸들과 특정 디바이스를 지정하는 SP_DEVINFO_DATA 대한 포인터가 포함됩니다. DIF 요청 외에도 이 구조체는 일부 SetupDiXxx 함수에서도 사용됩니다.

SP_DEVINFO_DATA 구조를 매개 변수로 사용하는 SetupDiXxx 함수는 제공된 구조체의 cbSize 멤버가 구조체의 크기(바이트)와 같은지 확인합니다. 입력 매개 변수에 대해 cbSize 멤버가 올바르게 설정되지 않으면 함수가 실패하고 ERROR_INVALID_PARAMETER 오류 코드가 설정됩니다. 출력 매개 변수에 대해 cbSize 멤버가 올바르게 설정되지 않으면 함수가 실패하고 ERROR_INVALID_USER_BUFFER 오류 코드가 설정됩니다.

요구 사항

   
머리글 setupapi.h(Setupapi.h 포함)

추가 정보

SP_DEVINFO_LIST_DETAIL_DATA