UcmTcpciPortControllerCreate 関数 (ucmtcpciportcontroller.h)

  • [アーティクル]

UcmTcpciCx に登録するポート コントローラー オブジェクトを作成します。

構文

NTSTATUS UcmTcpciPortControllerCreate(
  WDFDEVICE                        WdfDevice,
  PUCMTCPCI_PORT_CONTROLLER_CONFIG Config,
  PWDF_OBJECT_ATTRIBUTES           Attributes,
  UCMTCPCIPORTCONTROLLER           *PortControllerObject
);

パラメーター

WdfDevice

WdfDeviceCreate の前回の呼び出しでクライアント ドライバーが受信したフレームワーク デバイス オブジェクトへのハンドル。

Config

UCMTCPCI_PORT_CONTROLLER_CONFIG_INITを呼び出すことによって初期化されるUCMTCPCI_PORT_CONTROLLER_CONFIGへのポインター。 この値を NULL にすることはできません。

Attributes

新しいオブジェクトのドライバー指定の属性を含む WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、 WDF_NO_OBJECT_ATTRIBUTESできます。

PortControllerObject

新しいポート コントローラー オブジェクトへのハンドルを受け取る場所へのポインター。

戻り値

(NTSTATUS)メソッドは、操作が成功した場合STATUS_SUCCESSを返します。 それ以外の場合、このメソッドは適切な NTSTATUS エラー コードを返す可能性があります。

リターン コード 説明
STATUS_INVALID_DEVICE_REQUEST
 フレームワーク デバイス オブジェクトへのハンドルが無効です。
STATUS_INFO_LENGTH_MISMATCH
 Config または Config->機能が指す構造体のサイズが無効です。 それぞれ UCMTCPCI_PORT_CONTROLLER_CONFIG または UCMTCPCI_PORT_CONTROLLER_CAPABILITIESのサイズにする必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
ヘッダー ucmtcpciportcontroller.h
Library Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate