Funzione WdfDeviceInitFree (wdfdevice.h)

[Si applica solo a KMDF]

Il metodo WdfDeviceInitFree dealloca una struttura WDFDEVICE_INIT .

Sintassi

void WdfDeviceInitFree(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT .

Valore restituito

nessuno

Osservazioni

Se il driver riceve una struttura di WDFDEVICE_INIT da una chiamata a WdfPdoInitAllocate o WdfControlDeviceInitAllocate e se successivamente il driver rileva un errore quando chiama un metodo di inizializzazione dell'oggetto dispositivo o WdfDeviceCreate, il driver deve chiamare WdfDeviceInitFree.

Il driver non deve chiamare WdfDeviceInitFree dopo che chiama WdfDeviceCreate correttamente.

Il driver non deve chiamare WdfDeviceInitFree se ha ricevuto la struttura WDFDEVICE_INIT come input per la relativa funzione di callback EvtDriverDeviceAdd , perché il framework elimina la struttura dopo la restituzione della funzione di callback.

Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo framework.

Esempio

L'esempio di codice seguente chiama WdfDeviceInitFree se una chiamata a WdfPdoInitAssignRawDevice ha esito negativo.

NTSTATUS  status;

status = WdfPdoInitAssignRawDevice(
                                   pDeviceInit,
                                   &GUID_DEVCLASS_KEYBOARD
                                   );
if (!NT_SUCCESS(status)) {
    WdfDeviceInitFree(pDeviceInit);
    pDeviceInit = NULL;
    return STATUS;
}

Requisiti

Vedi anche

WdfDeviceCreate