SP_DRVINFO_DATA_V2_A 구조체(setupapi.h)

아티클
11/20/2024

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

통사론

typedef struct _SP_DRVINFO_DATA_V2_A {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  CHAR      Description[LINE_LEN];
  CHAR      MfgName[LINE_LEN];
  CHAR      ProviderName[LINE_LEN];
  FILETIME  DriverDate;
  DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_A, *PSP_DRVINFO_DATA_V2_A;

회원

cbSize

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

DriverType

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

SPDIT_CLASSDRIVER

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

SPDIT_COMPATDRIVER

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

Reserved

예약. 내부 전용입니다.

Description[LINE_LEN]

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

MfgName[LINE_LEN]

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

ProviderName[LINE_LEN]

이 드라이버의 공급자를 제공하는 NULL로 끝나는 문자열입니다. 일반적으로 드라이버 또는 INF 파일을 만드는 조직의 이름입니다. ProviderName 빈 문자열일 수 있습니다.

DriverDate

드라이버의 날짜입니다. DriverVer INF 파일의 항목입니다. DriverVer 항목에 대한 자세한 내용은 INF DDInstall 섹션 참조하세요.

DriverVersion

드라이버의 버전입니다. DriverVer INF 파일의 항목입니다.

발언

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 이상 버전에서만 실행되는 경우 식별자를 정의하지 마세요. 식별자가 정의되지 않은 경우 SP_DRVINFO_DATA_V2 사용됩니다.

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

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

메모

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