SP_DRVINFO_DATA_V1_W 구조체(setupapi.h)

아티클
08/26/2023

SP_DRVINFO_DATA 구조에는 드라이버에 대한 정보가 포함됩니다. 이 구조는 특정 디바이스 instance 연결되거나 디바이스 정보 집합과 전역적으로 연결할 수 있는 드라이버 정보 목록의 멤버입니다.

구문

typedef struct _SP_DRVINFO_DATA_V1_W {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  WCHAR     Description[LINE_LEN];
  WCHAR     MfgName[LINE_LEN];
  WCHAR     ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_W, *PSP_DRVINFO_DATA_V1_W;

멤버

cbSize

SP_DRVINFO_DATA 구조체의 크기(바이트)입니다. 자세한 내용은 이 항목의 설명 섹션을 참조하세요.

DriverType

이 구조체가 나타내는 드라이버의 형식입니다. 다음 값 중 하나여야 합니다.

SPDIT_CLASSDRIVER

이 구조체는 클래스 드라이버를 나타냅니다.

SPDIT_COMPATDRIVER

이 구조체는 호환되는 드라이버를 나타냅니다.

Reserved

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

Description[LINE_LEN]

이 드라이버에서 지원하는 디바이스를 설명하는 NULL로 종료된 문자열입니다.

MfgName[LINE_LEN]

이 드라이버에서 지원하는 디바이스 제조업체의 이름을 포함하는 NULL로 끝나는 문자열입니다.

ProviderName[LINE_LEN]

이 드라이버의 공급자를 제공하는 NULL로 종료된 문자열입니다. 일반적으로 드라이버 또는 INF 파일을 만드는 organization 이름입니다. ProviderName 은 빈 문자열일 수 있습니다.

설명

SetupAPI.h에서 이 구조는 소스 코드에 다음 줄을 포함하는지 여부에 따라 SP_DRVINFO_DATA_V1 또는 SP_DRVINFO_DATA_V2 동일합니다.

#define  USE_SP_DRVINFO_DATA_V1 1

구성 요소가 Windows 98 또는 Millennium Edition 또는 Windows NT 실행되어야 하는 경우에만 이 식별자를 정의합니다. 구성 요소가 Windows 2000 이상 버전의 Windows에서만 실행되는 경우 식별자를 정의하지 마세요. 식별자가 정의되지 않은 경우 SP_DRVINFO_DATA_V2 사용됩니다.

SP_DRVINFO_DATA_V1 DriverDate 및 DriverVersion 멤버를 포함하지 않습니다.

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

참고

setupapi.h 헤더는 SP_DRVINFO_DATA_V1 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.