SP_DEVICE_INTERFACE_DATA 구조체(setupapi.h)

아티클
03/13/2024

SP_DEVICE_INTERFACE_DATA 구조체는 디바이스 정보 집합에서 디바이스 인터페이스를 정의합니다.

구문

typedef struct _SP_DEVICE_INTERFACE_DATA {
  DWORD     cbSize;
  GUID      InterfaceClassGuid;
  DWORD     Flags;
  ULONG_PTR Reserved;
} SP_DEVICE_INTERFACE_DATA, *PSP_DEVICE_INTERFACE_DATA;

멤버

cbSize

SP_DEVICE_INTERFACE_DATA 구조체의 크기(바이트)입니다. 자세한 내용은 주의 섹션을 참조하세요.

InterfaceClassGuid

디바이스 인터페이스가 속한 클래스의 GUID입니다.

Flags

다음 중 하나 이상일 수 있습니다.

SPINT_ACTIVE

인터페이스가 활성(사용)입니다.

SPINT_DEFAULT

인터페이스는 디바이스 클래스의 기본 인터페이스입니다.

SPINT_REMOVED

인터페이스가 제거됩니다.

Reserved

예약되어 있습니다. 사용하지 마십시오.

설명

SP_DEVICE_INTERFACE_DATA 구조체의 instance 매개 변수로 사용하는 SetupAPI 함수는 제공된 구조체의 cbSize 멤버가 구조체의 크기(바이트)와 같은지 여부를 확인합니다. cbSize 멤버가 올바르게 설정되지 않으면 함수가 실패하고 ERROR_INVALID_USER_BUFFER 오류 코드를 설정합니다.