WDU_GetStringDesc()

DWORD DLLCALLCONV WDU_GetStringDesc	(	_In_ WDU_DEVICE_HANDLE	hDevice,
		_In_ BYTE	bStrIndex,
		_Outptr_ PBYTE	pbBuf,
		_In_ DWORD	dwBufSize,
		_In_ WDU_LANGID	langID,
		_Outptr_ PDWORD	pdwDescSize
	)

Reads a string descriptor from a device by string index.

Parameters

[in]	hDevice	A unique identifier for the device/interface.
[in]	bStrIndex	Index of the string descriptor to read.
[out]	pbBuf	Pointer to a buffer to be filled with the string descriptor that is read from the device. If the buffer is smaller than the string descriptor (dwBufSize < *pdwDescSize), the returned descriptor will be truncated to dwBufSize bytes.
[in]	dwBufSize	The size of the pbBuf buffer, in bytes.
[in]	langID	The language ID to be used in the get string descriptor request that is sent to the device. If langID is 0, the request will use the first supported language ID returned by the device.
[out]	pdwDescSize	An optional DWORD pointer to be filled with the size of the string descriptor read from the device. If this parameter is NULL, the funWDU_StreamReadction will not return the size of the string descriptor.

Returns

WinDriver Error Code

WDU_DEVICE *pDevice;
DWORD dwStatus;
BYTE bSerialNum[0x100];
DWORD dwSerialDescSize = 0;
 
dwStatus = WDU_GetDeviceInfo(hDevice, &pDevice);
if (dwStatus)
{
    return;
}
 
if (!pDevice->Descriptor.iSerialNumber)
{
    printf("Serial number is not available\n");
    goto Exit;
}
 
WDU_GetStringDesc(hDevice, pDevice->Descriptor.iSerialNumber,
    bSerialNum, sizeof(bSerialNum), 0, &dwSerialDescSize);
 
Exit:
    if (pDevice)
        free(pDevice);