Funzione WdfCollectionCreate (wdfcollection.h)
[Si applica a KMDF e UMDF]
Il metodo WdfCollectionCreate crea un oggetto raccolta framework.
Sintassi
NTSTATUS WdfCollectionCreate(
[in, optional] PWDF_OBJECT_ATTRIBUTES CollectionAttributes,
[out] WDFCOLLECTION *Collection
);
Parametri
[in, optional] CollectionAttributes
Puntatore a una struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante che contiene gli attributi per il nuovo oggetto raccolta. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.
[out] Collection
Puntatore a una posizione che riceve un handle per il nuovo oggetto raccolta.
Valore restituito
WdfCollectionCreare restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il chiamante ha fornito un valore di parametro non valido. |
|
Impossibile allocare un oggetto raccolta. |
Questo metodo può anche restituire altri valori NTSTATUS .
Osservazioni
Dopo aver chiamato WdfCollectionCreate per creare un oggetto raccolta framework, un driver può chiamare WdfCollectionAdd per aggiungere oggetti all'insieme.
Per impostazione predefinita, il padre del nuovo oggetto raccolta è l'oggetto driver del framework creato dal metodo WdfDriverCreate. È possibile utilizzare il membro parentObject della struttura WDF_OBJECT_ATTRIBUTES per specificare un elemento padre diverso. Il framework elimina l'oggetto raccolta quando elimina l'oggetto padre. Se il driver non modifica l'elemento padre predefinito, il driver deve eliminare l'oggetto raccolta al termine dell'utilizzo dell'oggetto ; in caso contrario, l'oggetto rimarrà fino a quando il gestore di I/O scarica il driver.
Per altre informazioni sugli insiemi di oggetti, vedere Framework Object Collections.
Esempi
Per un esempio di codice che usa WdfCollectionCreare, vedere WdfCollectionAdd.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfcollection.h (include Wdf.h) |
| libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |