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 포함) |