DRV_QUERYDEVICEINTERFACESIZE関数
DRV_QUERYDEVICEINTERFACESIZE メッセージは、デバイス インターフェイス名を保持するために必要なバッファーのサイズを照会します。
構文
DWORD xxxMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
パラメーター
uDeviceID
対象デバイスの ID を指定します。uMsg
呼び出し元は、xxxMessage を呼び出してこのデバイス メッセージを処理するときに、このパラメーターを DRV_QUERYDEVICEINTERFACESIZE に設定します。dwParam1
バッファー サイズへのポインター。 このパラメーターは、関数が必要なバッファー サイズをバイト単位で書き込む、ULONG 変数を指します。 サイズには、名前文字列の終端 null のストレージ領域が含まれます。 デバイス ID がデバイス インターフェイスを持たないデバイスを識別する場合、サイズは 0 です。dwParam2
未使用。 このパラメーターを 0 に設定します。
戻り値
xxxMessage 関数は、メッセージが正常に処理された場合、MMSYSERR_NOERROR を返します。 成功しなかった場合は、適切なエラー コードを返します。
解説
このメッセージは、waveInMessage、waveOutMessage、midiInMessage、midiOutMessage、mixerMessage 関数に対してのみ有効です。 システムはこのメッセージをインターセプトし、デバイス ドライバーにメッセージを送信することなく適切な値を返します。 システム インターセプト xxxMessage 関数の一般的な情報については、「システムインターセプトされたデバイス メッセージ」を参照してください。
このメッセージによって取得されるバッファー サイズは、バイト数として表されます。 デバイス インターフェイス名を含む null で終わる Unicode 文字列を保持するために必要なバッファーのサイズを指定します。 呼び出し元は、指定したサイズのバッファーを割り当て、DRV_QUERYDEVICEINTERFACE メッセージを使用してデバイス インターフェイス名の文字列を取得します。
詳細情報は、「デバイス インターフェイス名の取得」を参照してください。
要件
対象プラットフォーム |
デスクトップ |
バージョン |
Microsoft Windows Me および Windows 2000 以降のオペレーティング システムでサポートされます。 |
ヘッダー |
Mmddk.h (Mmddk.h を含む) |