IWDFDevice::SetPnpState-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die SetPnpState-Methode aktiviert oder deaktiviert die angegebene Plug & Play -Eigenschaft (PnP) eines Geräts.

Syntax

void SetPnpState(
  [in] WDF_PNP_STATE State,
  [in] WDF_TRI_STATE Value
);

Parameter

[in] State

Ein WDF_PNP_STATE typisierter Wert, der die festzulegende PnP-Eigenschaft identifiziert.

[in] Value

Ein WDF_TRI_STATE typisierter Wert, der angibt, wie die von State festgelegte PnP-Eigenschaft festgelegt wird. Die folgende Tabelle zeigt die möglichen Werte für Value.

Wert	Bedeutung
WdfUseDefault (0)	Legen Sie die PnP-Eigenschaft auf den Standardzustand fest.
WdfFalse (1)	Deaktivieren Sie die PnP-Eigenschaft.
WdfTrue (2)	Aktivieren Sie die PnP-Eigenschaft.

Rückgabewert

Keine

Bemerkungen

Bevor der Zustand der PnP-Eigenschaft, die SetPnpState festgelegt hat, wirksam werden kann, muss der Treiber die IWDFDevice::CommitPnpState-Methode aufrufen.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie angeben, dass ein Gerät aufgrund einer Anforderung fehlgeschlagen ist.

VOID
CUmdfHidDevice::OnCompletion(
    __in IWDFIoRequest* WdfRequest,
    __in IWDFIoTarget* /* WdfTarget */,
    __in IWDFRequestCompletionParams* WdfCompletionParams,
    __in PVOID /* Context */
    )
{
    ULONG_PTR bytesRead;

 if (!SUCCEEDED(WdfCompletionParams->GetCompletionStatus()))
    {
        m_WdfDevice->SetPnpState(WdfPnpStateFailed, WdfTrue);
        m_WdfDevice->CommitPnpState();
        return;
    }

    // Lock the device to prevent files from closing.
    m_WdfDevice->AcquireLock();

    // Retrieve the number of bytes that were read.
    bytesRead = WdfCompletionParams->GetInformation();

    // Process the reports.
    ProcessInputReports((PBYTE) m_ReadMemory->GetDataBuffer(NULL), bytesRead);

    m_WdfDevice->ReleaseLock();

    // Release the request.
    m_InterruptReadRequest = NULL;
    WdfRequest->DeleteWdfObject();

    // Send a new request.
    SendInterruptPipeRead();
}

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFDevice

IWDFDevice::CommitPnpState

IWDFDevice::GetPnpState

WDF_PNP_STATE