WdfCmResourceListAppendDescriptor 函式 (wdfresource.h)

發行項
03/05/2024

[僅適用於 KMDF]

WdfCmResourceListAppendDescriptor 方法會將資源描述元新增至指定資源清單的結尾。

語法

NTSTATUS WdfCmResourceListAppendDescriptor(
  [in] WDFCMRESLIST                    List,
  [in] PCM_PARTIAL_RESOURCE_DESCRIPTOR Descriptor
);

參數

[in] List

架構資源清單物件的句柄，代表裝置的硬體資源清單清單。

[in] Descriptor

描述硬體資源之CM_PARTIAL_RESOURCE_DESCRIPTOR 結構的指標。

傳回值

如果作業成功，WdfCmResourceListAppendDescriptor 會傳回STATUS_SUCCESS。否則，這個方法可能會傳回下列其中一個值：

傳回碼	Description
STATUS_INVALID_PARAMETER	指定了無效的參數。
STATUS_ACCESS_DENIED	驅動程式不允許將描述項新增至 List 參數指定的邏輯組態。例如，驅動程式無法修改其 EvtDevicePrepareHardware 或 EvtDeviceReleaseHardware 回呼函式收到的邏輯組態。
STATUS_INSUFFICIENT_RESOURCES	架構無法配置空間來儲存描述項參數所指定的描述項。

如果驅動程式提供無效的物件句柄，就會發生系統錯誤檢查。

備註

架構會將 CM_PARTIAL_RESOURCE_DESCRIPTOR 結構的內容複製到內部記憶體中，因此呼叫 WdfCmResourceListAppendDescriptor 的驅動程式例程可以在本機配置結構。驅動程式呼叫 WdfCmResourceListAppendDescriptor 之後，就可以重複使用 CM_PARTIAL_RESOURCE_DESCRIPTOR 結構。

如需資源清單的詳細資訊，請參閱 Framework-Based 驅動程式的硬體資源。

範例

下列程式代碼範例會將資源描述元新增至 EvtDeviceResourcesQuery 回呼函式收到的資源清單結尾。

NTSTATUS
PdoEvtDeviceResourcesQuery(
    IN WDFDEVICE  Device,
    IN WDFCMRESLIST  Resources
    )
{
    CM_PARTIAL_RESOURCE_DESCRIPTOR newDescriptor;
...
    newDescriptor.Type = CmResourceTypePort;
    newDescriptor.ShareDisposition = CmResourceShareDeviceExclusive;
    newDescriptor.Flags = CM_RESOURCE_PORT_IO|CM_RESOURCE_PORT_16_BIT_DECODE;
    newDescriptor.u.Port.Length = 1;
    newDescriptor.u.Port.Start = 0;

    status = WdfCmResourceListAppendDescriptor(
                                               Resources,
                                               &newDescriptor
                                               );
...

}

規格需求

需求	值
目標平台	Universal
最低 KMDF 版本	1.0
標頭	wdfresource.h (包含 Wdf.h)
程式庫	Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL	<=DISPATCH_LEVEL
DDI 合規性規則	DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)