HidD_GetProductString 함수(hidsdi.h)

HidD_GetProductString 루틴은 제조업체의 제품을 식별하는 최상위 컬렉션 포함된 문자열을 반환합니다.

통사론

BOOLEAN HidD_GetProductString(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  Buffer,
  [in]  ULONG  BufferLength
);

[in] HidDeviceObject

최상위 컬렉션에 대한 열린 핸들을 지정합니다.

[out] Buffer

루틴이 요청된 제품 문자열을 반환하는 데 사용하는 호출자 할당 버퍼에 대한 포인터입니다. 루틴은 NULL로 끝나는 와이드 문자열을 반환합니다.

[in] BufferLength

Buffer제공된 호출자 할당 버퍼의 길이(바이트)를 지정합니다. 버퍼가 NULL로 끝나는 전체 포함된 문자열을 반환할 만큼 충분히 크지 않은 경우 루틴은 버퍼에 아무 것도 반환하지 않습니다. 제공된 버퍼는 <= 4093바이트(2^12 – 3)여야 합니다.

HidD_GetProductString NULL로 종료된 전체 포함된 문자열을 성공적으로 반환하면 TRUE 반환합니다. 그렇지 않으면 루틴은 FALSE 반환합니다. GetLastError 사용하여 확장된 오류 정보를 가져옵니다.

사용자 모드 애플리케이션만 HidD_GetProductString호출할 수 있습니다. 커널 모드 드라이버는 IOCTL_HID_GET_PRODUCT_STRING 요청을 사용할 수 있습니다.

포함된 문자열에서 가능한 최대 문자 수는 디바이스별로 다릅니다. USB 디바이스의 경우 최대 문자열 길이는 126개의 와이드 문자입니다(종결 NULL 문자를 포함하지 않음).

특정 인터페이스에 대한 USB_DEVICE_DESCRIPTOR 구조의 iProduct 멤버는 다음 규칙에 따라 USB 공용 클래스 제네릭 부모 드라이버 의해 설정됩니다.

인터페이스에 대한 USB_INTERFACE_DESCRIPTOR 구조체의 iInterface 멤버가 0이 아니면 인터페이스에 대한 USB_DEVICE_DESCRIPTOR 구조체의 iProduct 멤버가 USB_INTERFACE_DESCRIPTOR 구조체의 iInterface 멤버로 설정됩니다.
인터페이스가 USB 인터페이스 연결 설명자 그룹화되고 인터페이스에 대한 인터페이스 연결 설명자의 iFunction 멤버가 0이 아닌 경우 인터페이스에 대한 USB_DEVICE_DESCRIPTOR 구조의 iProduct 멤버는 인터페이스 연결 설명자의 iFunction 멤버로 설정됩니다.

제공된 버퍼가 <= 4093바이트(2^12 – 3)가 아닌 경우 오류 코드 ERROR_GEN_FAILURE(0x0000001f)이 있는 기본 프로토콜, HID/Bluetooth/SPI에 따라) 호출이 실패할 수 있습니다.

자세한 내용은 HID 컬렉션참조하세요.

요구	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	보편적
헤더	hidsdi.h(Hidsdi.h 포함)
라이브러리	Hid.lib
DLL	Hid.dll