DevQueryDeviceNames - Parameters

hab (HAB) - input

Anchor-block handle.

pszDriverName (PSZ) - input

Fully-qualified name of the file containing the presentation driver.

The file-name extension is DRV.

pldn (PLONG) - in/out

Maximum number of device names and descriptions that can be returned.

On input, it must be greater or equal to 0. pldn can have the following values:

Zero

The number of device names and descriptions supported is returned; aDeviceName and aDeviceDesc are not updated.
Nonzero
pldn is updated to the number returned in aDeviceName and aDeviceDesc; aDeviceName and aDeviceDesc are updated.

aDeviceName (PSTR32) - output

Device-name array.

An array of null-terminated strings, each element of which identifies a particular device. Valid names are defined by presentation drivers.

aDeviceDesc (PSTR64) - output

Device-description array.

An array of null-terminated strings, each element of which is a description of a particular device. Valid descriptions are defined by presentation drivers.

pldt (PLONG) - in/out

Maximum number of data types that can be returned.

On input, it must be greater or equal to 0. pldt can have the following values:

Zero

The number of data types supported is returned, and aDataType is not updated.
Nonzero
pldt is updated to the number returned, and aDataType is updated.

aDataType (PSTR16) - output

Data type array.

An array of null-terminated strings, each element of which identifies a data type. Valid data types are defined by presentation drivers.

rc (BOOL) - returns

Success indicator.

TRUE

Successful completion
FALSE
Error occurred.

---

[Back: DevQueryDeviceNames Return Value - rc]
[Next: DevQueryDeviceNames - Remarks]