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 |