WdfDeviceSetSpecialFileSupport 関数 (wdfdevice.h)
[KMDF にのみ適用]
WdfDeviceSetSpecialFileSupport メソッドは、指定されたデバイスに対する特別なファイルに対するファンクション ドライバーのサポートを有効または無効にします。
構文
void WdfDeviceSetSpecialFileSupport(
[in] WDFDEVICE Device,
[in] WDF_SPECIAL_FILE_TYPE FileType,
[in] BOOLEAN FileTypeIsSupported
);
パラメーター
[in] Device
フレームワーク デバイス オブジェクトへのハンドル。
[in] FileType
ドライバー がサポートする特殊なファイルの種類を識別する、WDF_SPECIAL_FILE_TYPE型指定された列挙子。
[in] FileTypeIsSupported
ブール値を指定します。 TRUE の場合は特殊なファイルの種類のサポートを有効にし、 FALSE の場合は特殊なファイルの種類のサポートを無効にします。
戻り値
なし
解説
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
関数ドライバーは通常、EvtDriverDeviceAdd コールバック関数内から WdfDeviceSetSpecialFileSupport を呼び出します。
ドライバーが WdfDeviceSetSpecialFileSupport を呼び出すまで、特別なファイルに対する各ドライバーのサポートは、最初は無効になります。
詳細については、「 特別なファイルのサポート」を参照してください。
例
次のコード例では、デバイス上のページング、休止状態、ダンプ ファイルのサポートを有効にします。
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFilePaging,
TRUE
);
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFileHibernation,
TRUE
);
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFileDump,
TRUE
);
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
最小 KMDF バージョン | 1.0 |
Header | wdfdevice.h (Wdf.h を含む) |
Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
IRQL | <=DISPATCH_LEVEL |
DDI コンプライアンス規則 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |