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
                               );

要件

こちらもご覧ください

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE