PcCompletePendingPropertyRequest function (portcls.h)
The PcCompletePendingPropertyRequest function is called to complete a pending property request.
Syntax
PORTCLASSAPI NTSTATUS PcCompletePendingPropertyRequest(
[in] PPCPROPERTY_REQUEST PropertyRequest,
[in] NTSTATUS NtStatus
);
Parameters
[in] PropertyRequest
Pointer to the property request that was passed to the property handler. The request is a structure of type PCPROPERTY_REQUEST.
[in] NtStatus
Specifies the completion status of the request. See the list of NTSTATUS values defined in header file ntstatus.h.
Return value
PcCompletePendingPropertyRequest returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.
Remarks
If a miniport driver returns STATUS_PENDING from a property handler, it is obliged to keep a pointer to the property-request structure and to complete the request at some later time by calling this function.
The driver should call PcCompletePendingPropertyRequest only when the request is no longer pending. Never call this function with an NtStatus value of STATUS_PENDING.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | The PortCls system driver implements the PcCompletePendingPropertyRequest function in Microsoft Windows 98/Me and in Windows 2000 and later operating systems. |
| Target Platform | Universal |
| Header | portcls.h (include Portcls.h) |
| Library | Portcls.lib |
| IRQL | <=DISPATCH_LEVEL |