WdfPdoRetrieveAddressDescription - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// wdfpdo.h
NTSTATUS WdfPdoRetrieveAddressDescription(
[in] WDFDEVICE Device,
[in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);
View the official Windows Driver Kit DDI referenceNo description available.
[Applies to KMDF only]
The WdfPdoRetrieveAddressDescription method retrieves the address description that is associated with a specified framework device object.
Device [in]A handle to a framework device object that represents the device's physical device object (PDO).
AddressDescription [in, out]A pointer to a caller-allocated buffer that will receive the address description. The address description must contain a WDF_CHILD_ADDRESS_DESCRIPTION_HEADER structure.
If the operation succeeds, the function returns STATUS_SUCCESS. Additional return values include:
| Return code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | The Device handle does not represent a PDO. |
| STATUS_INVALID_DEVICE_REQUEST | The Device handle does not represent a device that was dynamically enumerated. |
The method might also return other NTSTATUS values.
A system bug check occurs if the driver supplies an invalid object handle.
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT
WdfChildListRetrieveAddressDescription
WdfPdoRetrieveIdentificationDescription